THE KNOWLEDGE.
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.
Read Docs →SDKs & Libraries
Native support for Python, JavaScript, Rust, and Go to accelerate your development speed.
Explore SDKs →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.