Everything you need to know about OsirisBrain, from installation to mastering your AI team.
OsirisBrainNano is an ultra-lightweight Go application that sits on your machine. It connects to local models (Custom Llama.cpp Engine) or cloud models (API) to power an autonomous engine that manipulates your OS, writes code, tests it, and remembers everything via SQLite.
OsirisBrain supports 10+ AI providers including OpenAI, Anthropic, Google Gemini, Groq, xAI, Mistral, OpenRouter, DeepSeek, Together, NVIDIA, and Custom Llama.cpp. Setting it up takes less than a minute; see the Settings & Configuration section below.
Go to the download section and pick "Apple Silicon" (for M1/M2/M3/M4 Macs) or "Intel" (for older Macs). Not sure? Click the Apple logo → "About This Mac" , if it says "Apple M1" (or M2, M3, M4), you have Apple Silicon.
Double-click the downloaded file. A window appears with the OsirisBrain icon and your Applications folder. Drag the icon into Applications.
Open your Applications folder and double-click OsirisBrain. The first time, macOS may ask: "Are you sure you want to open it?" Click Open. This only happens once.
Go to the download section and click "Windows". The .exe installer will download.
Double-click the downloaded file. Follow the installation wizard. You can choose where to install it or just use the default location. Click "Install" and wait a few seconds.
OsirisBrain will appear on your Desktop and Start Menu. Double-click it to launch. Windows Defender may show a SmartScreen warning the first time. Click "More info" → "Run anyway".
Go to the download section and click "Linux". The .AppImage file will download.
Open a terminal and run:
chmod +x OsirisBrain-2026.2.17.AppImage
Double-click the AppImage file, or run it from the terminal:
./OsirisBrain-2026.2.17.AppImage
No installation needed. AppImages are portable and run directly.
Click the Apple icon in the top-left corner of your screen → "About This Mac". If it says Chip: Apple M1 (or M2, M3, M4), download the "Apple Silicon" version. If it says Processor: Intel, download the "Intel" version.
Unlike Python-based AI agents, OsirisBrainNano is written completely in Go. This brings significant performance and reliability advantages out of the box.
A single compiled binary. Zero virtual environments, zero PIP installs, and sub-second boot times.
With no Global Interpreter Lock (GIL), the agent engine spawns thousands of parallel goroutines for subtasks without blocking.
Runs natively on Apple Silicon, Intel Macs, Windows, and Linux without fragile dependencies.
You have total freedom over where your intelligence comes from. OsirisBrainNano seamlessly blends local inference with cloud APIs.
Configure the engine for custom local compilation natively. Run Llama-3, Qwen, or Phi completely offline.
Connect multiple external providers at once: OpenAI, Anthropic, Gemini, DeepSeek, and Groq.
The engine automatically falls back to secondary models if your primary choice rate-limits you or fails.
OsirisBrainNano doesn't just scroll context blindly. It features a persistent SQLite memory engine partitioned like the human brain.
"What happened." Timestamped events tracking exactly what you discussed, what the agent deployed, and errors encountered.
"What I know." Extracts and permanently stores your specific preferences, project architecture rules, and API keys.
"How I do it." When the agent successfully solves a complex deployment or coding task, it saves the workflow to reuse later.
OsirisBrainNano is fully autonomous when writing code. It doesn't just give you snippets; it acts as an end-to-end developer.
The agent writes code directly to your filesystem based on the task prompt.
The engine intercepts the save, detects the language (Go, Python, JS, Rust), and silently runs go test, npm test, or eslint.
If the tests fail, the agent reads the stderr trace and immediately fixes its own bugs in the same logical turn without asking you.
Built directly from the engine/doctor.go module, OsirisBrainNano constantly audits itself for maximum reliability.
The agent comes equipped with 280+ ultra-optimized tools compiled directly into the binary. No PIP installs required.
Autonomous browser control via Chrome DevTools Protocol. The agent clicks, types, extracts state, and evaluates DOM.
Full stealth execution of bash/zsh scripts, file operations, grep searching, and system-level mutations.
Natively integrated to read your Gmail, scan your Calendar, and manage Google Drive architectures autonomously.
Ask the agent to execute specific sub-agents daily at 3:00 AM. It manages the heartbeat silently in the background.
All settings are entirely transparent and stored locally on your machine.
Navigate to ~/.osirisbrainnano/config.json in your terminal. Here you can edit models, swap providers, and link your custom GGUF models.
All sessions are encrypted at rest using AES-256-GCM.