The Knowledge Base
Welcome to the official documentation for BlackSpectron. Build, deploy, and scale autonomous AI systems using our proprietary neural fabric.
API Reference
Explore our comprehensive REST and WebSocket APIs for real-time autonomous orchestration.
SDKs & Libraries
Native support for Python, JavaScript, Rust, and Go to accelerate your development speed.
Introduction
BlackSpectron is fundamentally redesigning the relationship between human intent and software execution. Instead of writing code linearly, developers and founders use BlackSpectron to specify architectural requirements, and our Neural Fabric handles the orchestration.
This documentation will guide you through our autonomous principles, SDKs, and REST API endpoints. Whether you are generating a quick MVP in the Studio or scaling an enterprise cluster via our API, the underlying Fabric logic remains the same.
Quickstart Guide
To deploy your first autonomous agent, you'll need a BlackSpectron API key. Obtain one from your Executive Dashboard.
Initialize the SDK and deploy an agent:
const client = new Spectron({ apiKey: process.env.BS_API_KEY });
await client.agents.deploy({
role: 'Backend Engineer',
task: 'Provision a PostgreSQL database and create a User schema'
});
Fabric Architecture
The Neural Fabric is a distributed compute layer that scales dynamically based on the complexity of your request. It consists of three main components:
- Edge Nodes: Handle incoming REST requests and route intent to the optimal cluster.
- Reasoning Engines: Multi-modal LLMs (Nova, Galaxy, Ultimate) that break down the intent into actionable logic.
- Execution Sandboxes: Secure, isolated virtual environments where code is written, tested, and validated before deployment.
Autonomous Agents
Agents in BlackSpectron are not just chatbots; they are persistent, stateful workers that understand your codebase context. You can assign them specific roles such as `Frontend Designer`, `DevOps Architect`, or `Security Auditor`.
Agents communicate with each other over an internal message bus, allowing a `Frontend Agent` to request API endpoints from a `Backend Agent` entirely autonomously.
Neural Clusters
For enterprise clients on the BlackSpectron Business or Enterprise tiers, Agents can be grouped into Neural Clusters. A cluster is a dedicated compute slice optimized for high-frequency code generation and continuous integration.
Clusters guarantee zero queue times and provide a dedicated SLA for code execution speed.
Orchestration Logic
When multiple agents are working on a monolithic repository, the Orchestration Logic ensures that state changes do not conflict. It uses a proprietary DAG (Directed Acyclic Graph) engine to resolve dependencies.
For example, an API endpoint must be fully tested and deployed before the frontend agent is allowed to connect to it. This orchestration is completely invisible to the user.
SDKs & Libraries
BlackSpectron provides official SDKs for major programming languages, allowing you to interface with the Neural Fabric programmatically. Choose your preferred language below:
JS JavaScript / Node.js
The official Node.js SDK for server-side integration.
PY Python
Ideal for data science and orchestration logic.
GO Go (Golang)
High-performance SDK for concurrent agent deployment.
RS Rust
Memory-safe systems programming integration.
Product Documentation
BlackSpectron Studio
The ultimate cognitive workspace. Experience real-time logic synthesis, interactive sandboxed previews, multi-agent co-founding, and instant global edge deployments.
BlackSpectron Chat
Interact with context-aware developer agents trained on your system logic. Translate natural language goals into clean schema outlines, documentation structures, or code.
BlackSpectron Code
Our multi-agent code compilation suite. Run autonomous swarms in background sandboxes to build tests, verify type definitions, audit packages, and check deployment health.
BlackSpectron Arc
An AI-native browser companion that cleans out marketing overlays, promotional modals, and cookie walls, synthesizes web documentation, and formats pages into clean markdown files.
BlackSpectron Orbit
Our lightweight virtual operating system container. Connect remote cloud servers, run isolated container instances, and manage multi-region orchestrations seamlessly.
BlackSpectron CoWork
A real-time collaborative workspace where multiple human developers and AI nodes can pair program, comment, review changes, and share code canvases simultaneously.