metadist/synaplan
Own the flow: one open-source AI platform for your knowledge, models and channels – web, WhatsApp, email, Outlook, Nextcloud & ownCloud.
About metadist/synaplan
metadist/synaplan is an open-source project on GitHub, mainly written in PHP. Own the flow: one open-source AI platform for your knowledge, models and channels – web, WhatsApp, email, Outlook, Nextcloud & ownCloud. It currently holds 940 stars and 105 forks with 8 open issues, and was last pushed on 2026-11-15 (repository created 2025-03-30).
Project Overview
Git Homed tracks it on the Today's Trending board, currently at rank #46 with 67 new stars today.
GitHub Repository Details
README
Build AI assistants on your own documents and put them wherever work happens: web, WhatsApp, email, Outlook, Nextcloud and ownCloud. Mix local models with the best cloud AI, see what every answer costs, and decide what the AI is allowed to do – open source, on your server or ours.
Run it in up to five minutes · Try it hosted · Docs · Discord
Self-hosting is free. The hosted version opens with a paid plan or an invitation code – ask us at team@synaplan.com.
Chat, the cost of every answer, your files, generated media and connected apps – in about 30 seconds.
---
Why Synaplan
- Own your channels. One assistant answers on your website, in WhatsApp, by email, in Outlook and inside Nextcloud and ownCloud – with the same knowledge and the same rules everywhere.
- Own your models. Hundreds of models from OpenAI, Anthropic, Google, Mistral, sovereign EU providers or locally via Ollama. Mix them per task: sensitive work stays local, everything else gets the best model for the job.
- Own your costs. Every answer shows its model and price. A planner splits bigger requests into steps and spends the expensive model only where it matters.
- Own the decisions. Actions like sending mail or creating tickets wait for your approval, and every step is logged.
- Own the stack. On-prem, EU cloud or fully air-gapped. No training on your data, no forced telemetry, no feature paywall: self-hosted Synaplan is the same software as our cloud, under Apache-2.0.
---
Quickstart
You need: Docker with Compose v2 and 8 GB of RAM.
git clone https://github.com/metadist/synaplan.git
cd synaplan
make up
Open **, log in as admin@synaplan.com / admin123 and say hello. Your first message starts the Synaplan Demo – no API key needed (40 messages a day for 14 days, how it works). When you're ready, add your own key (free: Groq) or run local models with Ollama.
The first start downloads everything and takes 5–15 minutes. After that, Synaplan starts in seconds.
[!IMPORTANT]
These logins are for trying Synaplan on your own machine. On a server, use the installer – it creates its own admin password.
---
Install it your way
| Where | How | Guide |
| --- | --- | --- |
| Your machine | make up – the quickstart above | Quickstart |
| Published image, no git | One compose.yaml, then docker compose up -d | Published image |
| Docker GUI | Portainer, Dockge, Synology: paste the compose file as a stack | Docker GUI |
| Closed network | No route to the internet, HTTPS on your LAN address | Closed network |
| Linux server | The installer pins a release, generates secrets and runs a smoke test | On a server |
| Kubernetes | Helm charts for clusters | synaplan-charts |
| One click | RepoCloud · Elestio | – |
A Linux server in one line:
curl -fsSL https://raw.githubusercontent.com/metadist/synaplan/main/install.sh | \
bash -s -- --mode server --domain https://ai.example.com
Public sector & sovereign cloud (EU/CH): synaplan.eu covers openDesk, Nextcloud and OpenCloud deployments, on-premises or in an EU cloud.
---
How it compares
People usually arrive comparing Synaplan with a chat window or an app builder. This is what each project is for. It is not a scoreboard.
| | Synaplan | Open WebUI | LibreChat | Dify | | --- | --- | --- | --- | --- | | What it is | A team platform: chat, your files as knowledge, a site widget, and the same assistant on WhatsApp and email | A chat interface for local and cloud models | A chat app for many providers | A builder for AI apps and workflows | | First run | Several containers, about 4 GB | One container | A Compose stack | A Compose stack, and a hosted cloud | | Cost of an answer | Shown on the answer | Not on the answer | Not on the answer | In the builder's usage logs, not on the chat answer | | Same assistant on your site, WhatsApp and email | Yes | No | No | Site widget yes. WhatsApp and email are not built in |
If you only want a chat window, Open WebUI or LibreChat gets you there faster.
---
Take the tour
▶ Watch the full demo on YouTube · Click any screenshot to see it full size.
---
One AI, everywhere you work
The same assistant, the same knowledge, the same model policy – on every channel your team and your customers already use.
| Surface | What it does | Get it | | --- | --- | --- | | Web app | Full chat and admin UI, light and dark, five languages | This repo | | Mobile apps | Chat, documents and voice on iPhone and Android – on web.synaplan.com or your own server | App Store · Google Play | | Outlook add-in | Find and process mail inside Outlook (Web, new & classic, Mac) without sending it anywhere | Synamail | | Chat widget | Your assistant on any website with one snippet, human takeover included | Widget guide | | WhatsApp & email | The AI answers on the channel the question came in on | WhatsApp · Email | | Nextcloud, ownCloud & OpenCloud | Use your assistants inside your file cloud, with its files as knowledge – your file store stays in charge | Nextcloud · ownCloud · OpenCloud | | Synaplan Desktop | Pair a computer and run skills on it (no installer yet – build from source) | synaplan-desktop | | MCP & Claude Code | Your knowledge and memories as MCP tools, plus an Anthropic-compatible endpoint | MCP guide |
Connects to Microsoft 365 · Dropbox · Nextcloud / ownCloud / WebDAV · CalDAV · IMAP · Jira & Confluence · your own MCP servers – how to connect
---
Under the hood
- Stack: Symfony (PHP) backend, Vue frontend, MariaDB VECTOR or Qdrant for document search, Redis, Docker.
- Lean core: app, database and Redis. Local AI, office files, web search, voice and more are building blocks you switch on when you need them.
- Open by design: OpenAPI REST API, MCP server and client, an Anthropic-compatible
/v1/messagesendpoint and a plugin system – extend Synaplan without forking it.
---
Troubleshooting
| Problem | What to do |
| --- | --- |
| "Port already in use" on start | A port Synaplan needs is taken – see Port conflicts |
| Containers stop right after start | Give Docker at least 8 GB of RAM, then check docker compose logs -f backend |
| Chat gives no answers | Use the Synaplan Demo, paste one provider key, or add the local-ai profile – see the quickstart |
| First start seems stuck | The first start downloads all images and takes 5–15 minutes. docker compose logs -f startup-notes shows where it is |
| Anything else | Ask in Discord or open a GitHub issue |
---
Learn more
Help shape what's next
We build Synaplan in the open. Tell us what you'd use it for, vote on ideas or show what you built in Discussions – we read everything.
- 💬
License
Apache-2.0 · Built in Düsseldorf by metadist · Member of the Open Source Business Alliance
If Synaplan helps you own your flow, a ⭐ helps the next team find it.
