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.

npm install @blackspectron/core

Initialize the SDK and deploy an agent:

import { Spectron } from '@blackspectron/core';

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.

npm install @blackspectron/node
View GitHub Repository →

PY Python

Ideal for data science and orchestration logic.

pip install blackspectron
View GitHub Repository →

GO Go (Golang)

High-performance SDK for concurrent agent deployment.

go get github.com/blackspectron/go-sdk
View GitHub Repository →

RS Rust

Memory-safe systems programming integration.

cargo add blackspectron
View GitHub Repository →