Your AI assistant.
Your machine.
A capable terminal assistant and a small async agent SDK, in Python and TypeScript. Work with local models, keep your data private, and build at your own pace.
Python: scripts/andromeda · TypeScript: ./start.sh
›
src/app.py, then moves through the service layer before it reaches the database.The same agent, in Python or TypeScript.
They share the agent SDK foundations and settings. Pick the one your code lives in; each edition also has its own integrations and setup path.
Andromeda for Python
Type-hinted tools validated by Pydantic, a Textual terminal UI, and native voice, image and video generation.
from libs import Agent
Andromeda for TypeScript
Tools declared with zod, an Ink terminal UI, plugins and hooks, WhatsApp, an always-on daemon, event triggers, a usage dashboard, and voice, images and video with no Python.
import { Agent } from "./src/libs/index.ts"
Everything you need to get moving.
From your first run to building your own agent, find your way around Andromeda.
Introduction
Install Andromeda, set up your workspace, and make your first agent.
Using the CLI
Learn the terminal UI, keyboard shortcuts, permission modes, and commands.
Web app & dashboard
Run the authenticated web app, monitor live work, and use the dashboard to build, observe, and improve agent runs.
Core Concepts
Understand the agent loop, context, the knowledge graph, and learning.
Intelligence
Explore memory, subagents, planning, MCP, and background work.
Capabilities
Browse the web, use voice, generate media, and automate tasks.
Configuration
Tune your model, environment, and Andromeda settings.
Python & TypeScript
How the two frameworks compare, what they share, and feature parity.
Database
Every table in andromeda.db, how they reference each other, and one turn traced row by row.
Everything runs on your machine.
A full assistant out of the box, built from parts you can use on their own.
Three local engines
Ollama, Docker Model Runner, or llama.cpp with automatic GGUF downloads.
Memory that lasts
Thread history, working memory, and semantic recall backed by Qdrant.
Subagents & planning
Delegate work to parallel subagents and verify results before answering.
MCP servers
Connect any MCP server, or use the bundled ones for Gmail, git, Postgres and more.
Voice in and out
Talk with Kokoro or Qwen3-TTS speech, cloned voices and Whisper transcription.
Images & video
Generate and edit media locally, with a vision model checking the edits.
Real browser
Playwright browsing with accessibility snapshots small models can follow.
Git & your code
Safe git tools, a git MCP server and a knowledge graph of your repository.
You stay in control
auto, plan and ask permission modes with diff previews before edits.
Schedules & heartbeat
Recurring tasks, and a heartbeat that checks in when you have been away.
Skills
Drop in SKILL.md folders; Andromeda finds and loads them when relevant.
Sets itself up
Installs Ollama if needed and recommends real models that fit your machine.
Sources cited
Answers built on the web always list the pages they came from.
Desktop control
Sees the screen and uses apps on macOS, Windows and Linux, asking before each action.
Chat from WhatsApp
Message Andromeda from your phone; only your own chat can reach it.
An SDK underneath
Small async APIs in Python or TypeScript to build your own agents on.