muninn-ai 0.9.0

English · 繁體中文

Muninn is a personal assistant that runs on your own computer, and that you talk to in one conversation, on your phone or in a browser. It keeps track of what you are working towards, notices when you drift from the plan, and brings up only what matters, with what to do next. Whatever it does on its own can be undone; anything that cannot be taken back waits for your yes.

Install

On macOS or Linux, this installs Muninn, starts it in the background and opens its setup page:

curl -fsSL https://raw.githubusercontent.com/imaknas/muninn/main/install.sh | sh

Or with uv:

uv tool install muninn-ai
muninn init && muninn serve

On a NAS or a server: docker compose up -d (see compose.yaml). More in docs/install.md.

Getting started

1. On the setup page, pick a model and paste its key: Claude, any service with an OpenAI-style API, or a local model with Ollama.
2. Start talking to it, right there in the browser.
3. For your phone, open Settings → Pair a phone. With Tailscale on the computer, Muninn gives itself an HTTPS address on your tailnet; scan the code.
4. The rest is on the settings page too: the folders it reads activity from, connecting Google (mail and calendar, step by step), and adding form filling.

muninn upgrade moves to the latest release, muninn check says what in the settings cannot work as written, muninn backup DIR copies your data, and muninn uninstall takes Muninn off the computer again.

What it does

• One conversation. Tell it what happened, ask it things, answer what it asks. No forms.
• Goals and deadlines, per part of your life. It measures progress from what it observes and nudges you when you fall behind, within daily limits and quiet hours.
• A morning brief, an evening summary and a weekly reflection.
• Mail and calendar. Google: it reads mail, saves reply drafts and blocks time in a calendar of its own. Microsoft 365: it reads. It never sends mail or answers an invitation for you.
• Job applications. It prepares each one from the posting and your documents; with the autofill extra installed it also fills in Greenhouse forms, for you to send with one tap.
• Your coding projects. A project can hand it to-dos and questions only you can settle (Principal Handoff), and with a session runner (such as agent-hub) a conversation can be lent to a project's own session.
• English or Traditional Chinese, throughout.

Privacy

Muninn runs on your machine, and what it knows stays in its data/ folder. One setting decides where models run: cloud sends every request to the cloud model you chose; privacy keeps work and anything unattributed on a local model, and gives the cloud only whitelisted fields. You can cap what cloud models cost per day, and every device has to be paired. Details in docs/privacy.md; vulnerabilities go to SECURITY.md.

Documentation

• Installing: install, upgrade, Docker, HTTPS for your phone
• How it works: domains, goals, what it observes, what it does for you
• Privacy: where models run and what leaves the machine
• Contracts: interfaces for other systems
• Contributing: developing, testing, releasing
• Changelog: what changed in each release

License

Apache-2.0