Joanium

The AI desktop assistant that actually lives on your machine.
_{Multi-model chat · Scheduled automations · Background agents · MCP · Real integrations}

🌐 Website · 📖 Docs · 🛍️ Marketplace · ⬇️ Download · 💬 Discussions

Joanium is a local-first AI desktop app that goes far beyond a chat window. It knows your projects and files, runs automations on a schedule, operates background agents, connects to GitHub / Gmail / Drive, and supports every major AI provider — all without sending your data to the cloud.

Those are great chat apps. Joanium is a different product entirely — it lives on your machine, understands your workspace, runs jobs while you sleep, and plugs into the tools you actually use.

Joanium loads your active project, reads your files, runs terminal commands, handles attachments, and maintains separate chat history per project. Not a blank box — a genuine 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 required.

Built-in data sources: RSS feeds, Reddit, weather, crypto prices, file reads, URL fetches, GitHub events, and more. Built-in outputs: notifications, file writes, webhooks, terminal commands, Slack messages, email, and integration-specific actions.

Reusable scheduled prompts that run against any model, any project. Perfect for daily code reviews, changelog monitoring, PR summaries, or anything you'd otherwise have to remember to ask manually.

• Personas change how the assistant thinks — drop in a "senior code reviewer" or a "startup copywriter" and the whole interaction shifts instantly.
• Skills are markdown docs that teach the assistant what to do — enable the ones you need, disable the rest. Both are just plain files you can edit, version-control, and share.

GitHub · GitLab · Gmail · Google Drive · Google Calendar · Google Sheets · Google Docs · Google Contacts · YouTube · Google Tasks

All connected as first-class tools the assistant can actually invoke mid-conversation.

Connect any MCP-compatible server and expose its tools directly to the assistant. The ecosystem is growing fast — Joanium keeps up.

Browse and install community-built Skills and Personas with one click. Publish your own.

1. Go to https://joanium.com
2. Click Download  (Windows · macOS · Linux — all supported)
3. Install and run the onboarding wizard
4. Add an API key for your preferred AI provider

💡 No paid API key? Joanium supports Ollama and LM Studio for free fully-local models with zero extra configuration.

Switch models anytime, even mid-conversation. No lock-in, ever.

Contributions are very welcome — big or small. Here's how to get started:

git clone https://github.com/joanium/joanium.git
cd joanium
npm install
npm run dev          # start in dev mode
npm run lint         # check code style

See CONTRIBUTING.md for the full guide, CODE_OF_CONDUCT.md for community norms, and SECURITY.md for responsible disclosure.

• GitHub Discussions — questions, ideas, show-and-tell
• Issues — bug reports and feature requests
• CHANGELOG — full release history

This project is licensed under the Apache License 2.0.

See LICENSE for the full terms.

If Joanium is useful to you, a ⭐ on GitHub goes a long way.
Made with ❤️ by Joel Jolly