Build It Right FirstAgents you run. Parts you can reuse.
The Aivyx Ecosystem is two local-first AI agents — a personal assistant and a coding agent — and the shared building blocks they're built from. Software you run on your own hardware, not a service you rent.
The agents
A self-learning personal AI agent — capability-secured, audited, encrypted at rest. Runs as a daemon with a Studio UI, Telegram/Discord/Slack, or CLI.
Stable from 1.0: config, CLI, data and pack formats follow semantic versioning. The Matrix, Signal and Proton Mail channels and YubiKey unlock are previews.
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/Aivyx-Agent/aivyx-pa/releases/latest/download/aivyx-cli-installer.sh | sh
aivyx-pa init # finds your model, sets it up, checks it works
A terminal coding agent for local LLMs only — Ollama, Lemonade, llama.cpp, Docker Model Runner, vLLM, Jan. Never calls a cloud API. Sandboxed, permission-gated, with undo.
Stable from 1.0: config, CLI flags, the --report schema, sessions and ACP follow semantic versioning.
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/Aivyx-Agent/aivyx-coder/releases/latest/download/aivyx-coder-installer.sh | sh
cd your-project && aivyx-coder # finds your model, sets it up, opens the TUI
Before you install
A model to talk to
Both agents use a model you run yourself: Ollama, Lemonade, llama.cpp, Jan or Docker Model Runner. Start one first and setup finds it. Aivyx PA can also use a cloud account (Anthropic or OpenAI) under your own key; aivyx-coder is local only.
Other ways to get Aivyx PA
- Desktop app: a
.deb for Ubuntu and Debian, or the macOS app. - Windows: a ready-made WSL distribution, or Docker.
- Docker: an always-on server, with every tool included.
aivyx-coder runs on Linux and Apple Silicon Macs (and in WSL on Windows).
Using both
They're separate programs: install each with its own command and point both setups at the same model server. If you like, Aivyx PA can then hand coding tasks to aivyx-coder.
Step-by-step: get started →
Built on shared building blocks
Both agents are built from small Rust crates — most of them shared.
- aivyx-confineA sandbox for every command an agent runs
- aivyx-checkpointUndo for agent actions
- aivyx-injection-guardSpots prompt injection in what an agent reads
- aivyx-yubiAn agent identity key that lives on a YubiKey
- aivyx-recallNotes that last between sessions
- aivyx-kvcacheKeeps a long prompt warm between runs
- aivyx-brokerShares one local GPU between agents
- aivyx-routePicks the right model for each request
- aivyx-skillsA shared library of SKILL.md guides
- aivyx-visionGraphics as agent tool calls
- aivyx-packSigned packs that set an agent up for one kind of work
- aivyx-stencilKeeps a local model's tool calls well-formed
All building blocks →
"The agent gains autonomy by your choice — never one it grows into on its own."
The line that makes trusting an autonomous agent reasonable.Packs
LiveAivyx Hub
The first-party place to get signed packs for Aivyx PA and aivyx-coder, each one setting an agent up for one kind of work. Free; the first pack is Business Manager.
What's next
Specced, not built yet. No dates — they ship when they're right.
PlannedAivyx Nexus
A directory where agents run by different people can find each other and check who they're dealing with.
PlannedAivyx Factory
Several machines, one operator, working as one team of agents.
PlannedAivyx Creator
A studio for building agent setups that someone else runs on their own hardware.