Conker

A personal AI companion you host yourself.
It remembers you, shows its work, and never acts without your say.

Overview · How it works · Using it · Running it · Status

What it does

• Talks and remembers. Memories carry their source, and you can see why it knows something.
• Shows its work. Every answer shows which memories, tools and model it used.
• Asks before acting. Actions go through one controlled gate. You approve the exact action, once.
• Stays yours. Runs on your hardware, on your private network, with local models by default.

Status: early. The current source has 33 of 35 tracked capability families active; live voice and the production owner terminal remain deferred. The current tree still needs assembled Linux release acceptance before rollout. Full status

Try it locally

The real interface with demo data, no server needed. Needs Node.js 22.12 or newer:

git clone https://github.com/Conker-AI/conker.git
cd conker/dashboard
npm ci
npm run dev -- --host localhost --port 5173 --strictPort

Open http://localhost:5173 and start chatting. Answers, memories and approvals are simulated in the browser; ask it to email someone to see an approval. To run the real thing on a server, see 4 · Running Conker.

How it's built

flowchart LR
    You([You]) --> GW[Gateway] --> Pi[Pi<br/>conversations]
    Pi --> MG[MemoryGate<br/>remembers]
    Pi --> TG[ToolGate<br/>acts, with approval]
    Pi --> SG[SystemGate<br/>observes]
    Pi --> M[Models<br/>local or hosted]

Loading

Six small services, each in its own repository and usable on its own: pi · memorygate · toolgate · systemgate · embeddings. More in 2 · How it works.

Docs

1 · Overview	What Conker is, why, and the 10 words it uses
2 · How it works	Diagrams: services, one message, one approval
3 · Using Conker	Each screen and common tasks
4 · Running Conker	Preview, server, local Windows stack
5 · Developing	Repos, checks, rules, decisions
Status	What works today, and what doesn't

Credits

The frontend builds on shadcnstore's dashboard template (notice), React, Vite, Tailwind CSS and Radix.

License and security

MIT. Found a vulnerability? Please report it privately: security policy.