metadist/synaplan

▲ 67 stars today★ 940⑂ 105

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

Repository metadist/synaplan · default branch main · size 189196 KB · watchers 31 · source: GitHub REST API and repository README

README

https://github.com/metadist/synaplan/blob/HEAD/Synaplan. Own the flow. Your knowledge, your models, your channels.

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

Latest release GitHub stars Discord

Self-hosting is free. The hosted version opens with a paid plan or an invitation code – ask us at team@synaplan.com.

https://github.com/metadist/synaplan/blob/HEAD/A thirty-second tour of Synaplan: a chat answer and its cost, default models with cost badges, the file library, generated images and audio, and connected apps

Chat, the cost of every answer, your files, generated media and connected apps – in about 30 seconds.

---

Why Synaplan

Running in production at Megaherz Yoga · SANI Pflegedienst · National Secure Cloud · PlateArt

---

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

A tour through Synaplan: chat with live cost tracking, one-key provider setup, per-task model choice, document search, media generation, the embeddable chat widget and white-label branding

▶ Watch the full demo on YouTube  ·  Click any screenshot to see it full size.

https://github.com/metadist/synaplan/blob/HEAD/Chat with per-model cost tracking
Chat
Every answer shows what it cost
https://github.com/metadist/synaplan/blob/HEAD/AI provider setup with live key validation
Provider setup
One key, tested and encrypted
https://github.com/metadist/synaplan/blob/HEAD/Per-task model selection with cost badges
Model choice
A different model per task
https://github.com/metadist/synaplan/blob/HEAD/Semantic search across uploaded documents
Document search
Answers from your own files
https://github.com/metadist/synaplan/blob/HEAD/Gallery of AI-generated images and video
Media generation
Images, video and audio in chat
https://github.com/metadist/synaplan/blob/HEAD/Embed code for the chat widget
Chat widget
One snippet, any website
https://github.com/metadist/synaplan/blob/HEAD/System prompt editor
AI instructions
Your own system prompts
https://github.com/metadist/synaplan/blob/HEAD/File manager with folders and storage quota
Files
Uploads become knowledge
https://github.com/metadist/synaplan/blob/HEAD/Plugin view showing Synaform collections
Plugins
Extend without forking
https://github.com/metadist/synaplan/blob/HEAD/Admin panel with system info and user counts
Admin
Users, usage and health
https://github.com/metadist/synaplan/blob/HEAD/White-label branding settings
Branding
White-label the whole app

---

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

Full feature list, every AI provider, all building blocks and developer commands: Platform reference.

---

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

https://github.com/metadist/synaplan/blob/HEAD/OSBA member

If Synaplan helps you own your flow, a ⭐ helps the next team find it.

https://github.com/metadist/synaplan/blob/HEAD/Star history of metadist/synaplan

GitHub Stars & Activity

940Stars
105Forks
8Open issues
PHPLanguage

GitHub Popularity

GitHub stars940
Forks105
Open issues8
Primary languagePHP
LicenseApache-2.0
Stars gained today67
Created2025-03-30
Last pushed2026-11-15

Trending History

Daily boardrank #46 · ▲ 67 stars

Related GitHub Projects

1

coollabsio / coolify

PHP★ 66,097⑂ 5,991▲ 34 stars
→
2

InvoiceShelf / InvoiceShelf

PHP★ 2,023⑂ 419▲ 22 stars
→
3

mattpocock / skills

Shell★ 324,722⑂ 27,265▲ 706 stars
→
4

obra / superpowers

Shell★ 317,811⑂ 28,304▲ 428 stars
→
5

msitarzewski / agency-agents

Shell★ 168,432⑂ 27,323▲ 232 stars
→
6

ggml-org / llama.cpp

C++★ 135,142⑂ 25,639▲ 240 stars
→
7

JuliusBrussee / caveman

Go★ 120,274⑂ 7,011▲ 227 stars
→
8

addyosmani / agent-skills

JavaScript★ 117,718⑂ 12,322▲ 411 stars
→

More Trending Repositories