Space Black is a terminal-based AI infrastructure designed to host autonomous agents. It provides the body (CLI, file system access, browser engine, encrypted memory) that an AI agent needs to live and work on your local machine.
Ghost is the default AI agent running on Space Black. It is a self-evolving, persistent personality that acts as your pair programmer, researcher, and automated assistant. Let Ghost surf the web, read your code, and manage your tasks.
Space Black leverages modern frameworks to run heavy agentic workloads natively:
| Component | Technology | Description |
|---|---|---|
| Core | Python 3.10+ | Extensible infrastructure and native bindings. |
| Agent Mind | LangGraph / LangChain | ReAct execution loops (Reason → Act → Observe). |
| Interface | Textual | A beautiful, high-performance Terminal UI. |
| Browser Engine | Playwright & CDP | Automates Chromium using Accessibility Trees for GUI vision. |
| Security | OS Keychain & AES-256 | Fuses native OS keychains with an encrypted local file vault. |
- Memory: Ghost maintains a relationship with you, storing preferences in
brain/USER.mdand semantic facts inbrain/memory/. - Vault System: Zero-config encrypted vault — passwords and API keys are AES-encrypted at rest with a machine-local key. No passphrase needed.
- Self-Evolution: Ghost dynamically updates its own core personality prompt (
brain/SOUL.md).
Space Black supports massive model variety (gpt-4.5-preview, claude-3-7-sonnet, gemini-2.5-flash, deepseek-r1) and provides Ghost with powerful tools:
| Skill / Tool | Description |
|---|---|
| 🌐 Autonomous Browser | Surfs the live web, sees page structure natively, clicks, and navigates SPAs. |
| 👔 Google Workspace | Reads Gmail, parses Drive docs, and manages Calendar events via local OAuth. |
| 🍏 macOS Control | Deep native integration via AppleScript (Apple Mail, Notes, Reminders, Finder). |
| 🐙 GitHub | Control repositories, fetch issues, manipulate branches, and direct code commits. |
| 🎫 Jira | Natively manage Atlassian tickets, comments, and project states autonomously. |
| 💳 Stripe & PayPal | Secure billing interactions, invoice generation, and payouts. |
| 🗣️ Native Voice | Built-in seamless Speech-to-Text and auto Text-to-Speech (STT/TTS). |
| 🤖 Discord/Slack/Telegram | Run background bots to manage servers and chat with Ghost remotely. |
The fastest way to get started. Automatically detects your OS and installs the .deb, .rpm, or compiles from source.
curl -fsSL https://spaceblack.info/install.sh | bashgit clone https://github.com/udaysagarm/SpaceBlack.git
cd SpaceBlack
# Mac / Linux
./ghost start
# Windows (PowerShell)
.\ghost.bat startThe ghost start command automatically creates a virtual environment, installs dependencies, and launches the UI.
Dive deeper into the infrastructure and Agent mechanics inside the docs/ folder:
| Guide | Description |
|---|---|
| CLI Commands | Full CLI reference (ghost start, ghost daemon, ghost update). |
| User Manual | Interaction guide, Voice Mode shortcuts, and integration prompts. |
| Installation | Detailed requirements, advanced .env setup, and manual setups. |
| Browsing | How Ghost converts React/Vue DOM structures into readable Contexts. |
| Architecture | How Space Black's ReAct loop passes tools to the LangGraph runner. |
| Packaging | Guide for compiling the .deb and .rpm native Linux packages. |
| Security | Details on AES vault encryption and token safety. |
This project is licensed under the MIT License.