Skip to content
Conker-AIPublic

About

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

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1,550 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Conker

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

CI Dashboard AGPL-3.0 license Self-hosted

A Conker chat: a weekly plan, with what was added to memory

What it does

  • Talk to the models you choose. Local models through Ollama, hosted ones through OpenRouter, OpenAI or Anthropic, or sign in with a ChatGPT or Claude plan. Answering, thinking and reviewing each get their own model, or let Auto pick.
  • Remembers, with sources. Every memory keeps where it came from. Correct or forget any of them from the Memory screen.
  • Acts only as you allow. Every action goes through ToolGate. Your settings decide, per chat, agent and tool, whether it runs, the AI reviewer decides, or you are asked. When the reviewer decides, anything that reaches a real person or can't be undone still comes to you.
  • One Inbox. Approvals, Conker's own requests (a cron job, a tool, a memory) and its ideas wait in one place, one card each: do it, don't, or change it.
  • Works while you're away. Cron jobs are your own instructions, run by the AI with tools on a schedule, an event or a webhook, within the budgets you set.
  • A terminal for agents, not for your server. Each command runs in a fresh locked-down container with no network; packages arrive only through a read-only proxy.
  • Everything is a setting. 102 settings that take effect (221 more planned), one pattern, searchable. The same settings work from the terminal with conker config.

A look around

Home: what needs you, plan allowance and what's coming up
Home. What needs you, what's coming up, how much of each plan is left.
Inbox: one card per approval, request and idea
Inbox. One card per decision, with the buttons that fit it.
Memory map: memories, people and their sources
Memory. What Conker knows, and the chat each fact came from.
Settings: topics on the left, one row pattern on the right
Settings. Every setting by topic, in one pattern.

Screenshots show the built-in preview with sample data.

Quickstart

See it in five minutes. The interface runs on its own with sample data. Needs Git and Node.js 22.12+.

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. Answers, memories and approvals are simulated in the browser. CI runs these lines as written on every dashboard change and fails if the page is not up within five minutes (scripts/check_quickstart.py).

Install on a server. Any Linux machine with Docker (WSL2 works too). 16 GB of RAM is comfortable for local models.

git clone https://github.com/Conker-AI/conker.git
cd conker
./install.sh

The installer checks the machine, generates every secret, pulls the pinned images and prints one address. It then offers ./conker setup, a guided first run that asks one plain question at a time. Day to day:

./conker status          # is everything working, and what isn't
./conker update          # a pinned release, verified, with rollback
./conker config list     # every setting, from the terminal
./conker backup          # a verified snapshot

Other ways to run it, including a native development stack on Windows and the source-built Ubuntu layout: 4 · Running Conker.

Status

Conker is early. The current source has 40 of 41 tracked capability families active; the owner's own terminal is still deferred. Local models on a CPU work but are slow; a hosted or larger model makes tool use and drafts much more reliable. What works today

How it's built

Small services with one job each, so every boundary is a process boundary. Each has its own repository and runs on its own.

flowchart LR
    You([You]) --> GW[Gateway<br/>login, approvals]
    GW --> Pi[Pi<br/>conversations]
    Pi --> MG[MemoryGate<br/>remembers]
    Pi --> TG[ToolGate<br/>acts, as allowed]
    Pi --> SG[SystemGate<br/>observes]
    Pi --> M[Models<br/>local or hosted]
    MG --> EM[Embeddings]
    TG --> SB[Sandbox<br/>agent terminal]
Loading
Repository Job Release
pi Conversations, model roles, the gateway and a record of every turn Pi release
toolgate The only way to act: typed tools, exact approvals, spending limits, the sandbox ToolGate release
memorygate Memory with sources: evidence in, bounded context out MemoryGate release
systemgate A read-only view of the machine SystemGate release
embeddings Text to vectors, and nothing else Embeddings release

This repository holds the app, the installer, deployment and the docs. versions.env pins the exact release of each service. More in 2 · How it works.

Docs

1 · Overview What Conker is, why, and the words it uses
2 · How it works Services, one message, one approval, in diagrams
3 · Using Conker Each screen and common tasks
4 · Running Conker Install, update, back up, recover
Looking after your server Update, back up, restore and roll back, in plain steps
5 · Developing Repositories, checks, rules, decisions
Status What works today, and what doesn't yet

Credits

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

License and security

AGPL-3.0, version 3 only. Copyright (C) 2026 alexeybe1kin. Releases published before 24 October 2026 were under MIT and stay under MIT. Found a vulnerability? Please report it privately: security policy.

About

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

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages