Think once, Ship more
Joanium is a local-first desktop app for people who want an AI assistant that can actually work with projects, files, tools, schedules, personal context, and real integrations instead of acting like a thin chat wrapper.
It combines multi-provider chat, workspace-aware assistance, scheduled automations, autonomous agents, MCP, browser tooling, markdown-based skills and personas, and a discovery-driven extension system in one desktop product.
Those are great chat apps. Joanium is a different thing entirely — it lives on your machine, knows your files, runs jobs while you sleep, and connects to the tools you actually use.
| ChatGPT / Claude.ai | Joanium | |
|---|---|---|
| Your files & projects | ❌ Upload every time | ✅ Always in context |
| Runs tasks on a schedule | ❌ | ✅ Automations + Agents |
| GitHub, Gmail, Drive integrations | ❌ Limited | ✅ Native |
| Your data stays on your machine | ❌ Cloud only | ✅ 100% local-first |
| Use any AI model | ❌ Locked in | ✅ 10+ providers |
| Extensible with custom tools | ❌ | ✅ Full extension system |
Not just a blank box. Joanium loads your active project, reads your files, runs terminal commands, handles attachments, and keeps separate chat history per project. It's the difference between an assistant and a coworker.
Set up a job once — "every morning, pull the latest GitHub issues, summarise them, and ping me on Slack" — and it just runs. No babysitting. Built-in data sources include RSS, Reddit, weather, crypto prices, file reads, URL fetches, and more. Built-in outputs include notifications, file creation, webhooks, terminal commands, and integration-specific actions.
Reusable scheduled prompts that run against any model and any project. Great for daily code reviews, monitoring changelogs, or anything you'd otherwise have to remember to ask manually.
Personas change how the assistant talks and thinks — drop in a "senior code reviewer" or a "startup copywriter" and the whole vibe shifts instantly. Skills are markdown docs that teach the assistant what to do — enable the ones you need, disable the rest. Both are just files you can edit or share.
GitHub, GitLab, Gmail, Google Drive, Calendar, Sheets, Docs, Contacts, YouTube, Tasks — all connected as first-class tools the assistant can actually use mid-conversation, not just talk about.
Browse and install community-built skills and personas from the Joanium marketplace with one click. Ship your own too.
1. Go to https://joanium.com
2. Hit Download
3. Install it (Windows · macOS · Linux — all supported)
4. Finish onboarding — add your API key and you're live
💡 No API key? Use Ollama for free local models — Joanium supports it out of the box with zero extra config.
Switch models anytime, even mid-conversation. No lock-in, ever.
Anthropic · OpenAI · Google Gemini · OpenRouter · Mistral · NVIDIA NIM · DeepSeek · MiniMax · Ollama · LM Studio
Full walkthrough → Docs/Extension-Guide.md
| 🗺️ Architecture | How the app boots, runtime layers, and request flow |
| 🧩 Features | Full product surface and capability map |
| 💾 Data & Persistence | Where state lives and how to back it up |
| 🔧 Extension Guide | Adding features, engines, pages, IPC, and services |
| 📍 Where To Change What | Targeted maintenance map — find the right file fast |
| 🛠️ Development Workflow | Scripts, packaging, and contributor workflow |
Contributions are welcome — big or small.
- CONTRIBUTING.md — how to get started
- CODE_OF_CONDUCT.md — be cool
- SECURITY.md — reporting vulnerabilities
MIT. See LICENSE.
Made with ❤️ by Joel Jolly