synaplan

metadistApache-2.0活跃维护

开源 AI 平台,把知识库、模型和多渠道消息(网页、WhatsApp、邮件、Outlook、Nextcloud)统一编排,本地与云端模型可并用,每条回答都标出成本。

Own the flow: one open-source AI platform for your knowledge, models and channels – web, WhatsApp, email, Outlook, Nextcloud & ownCloud. Local and cloud models side by side, with the cost on every answer.

v5.7.2发布于 2026-11-09 19:02 UTC821star +125 / 7 天92fork同步于 2026-11-10 23:53 UTC

怎么上手

由 README 提炼,执行前请确认
git clone https://github.com/metadist/synaplan.git
cd synaplan
make up
硬件要求按 README 说明

需要 Docker Compose v2 和 8 GB 内存;本地模型通过 Ollama 运行,README 未说明具体显存要求。

有 Docker 镜像
下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

开源 AI 助手平台,把自有文档变成知识库并投放到网站、WhatsApp、邮件等渠道

开源 AI 平台,把知识库、模型和多渠道消息(网页、WhatsApp、邮件、Outlook、Nextcloud)统一编排,本地与云端模型可并用,每条回答都标出成本。

核心能力

  • 同一助手接入网站、WhatsApp、邮件、Outlook、Nextcloud 等渠道
  • 按任务混用本地 Ollama 与云端模型,敏感任务留在本地
  • 每条回答显示所用模型与费用,规划器拆分大请求省成本
  • 发邮件、建工单等动作需人工审批并记录每一步
  • 提供 OpenAPI、MCP 与 Anthropic 兼容接口,插件扩展无需分叉

容易踩的坑

首次启动要下载全部组件,需 5–15 分钟;默认登录 [email protected] / admin123 仅限本机试用,服务器上应改用安装脚本生成密码;首次对话走 Demo 模式,每天 40 条、限 14 天,之后需自备 API key 或接 Ollama。

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v5.7.2
  1. v5.7.2Synaplan v5.7.2最新正式版2026-11-09 · 2026-11-09 19:02 UTC

    What's Changed

  2. v5.7.1Synaplan v5.7.12026-11-05 · 2026-11-05 12:57 UTC
    查看更新说明

    What's Changed

    Full Changelog: https://github.com/metadist/synaplan/compare/v5.7.0...v5.7.1

  3. v5.7.0Synaplan v5.7.02026-11-04 · 2026-11-04 17:10 UTC
    查看更新说明

    Including the security fixes from v5.6.7 and some important updates, we go up to 5.7 now. Here is the list - the 5.6.7 is also very relevant! If you are on 5.6.6 or earlier: update for security reasons. The data is maintained and your settings stay.

    What's Changed

    Full Changelog: https://github.com/metadist/synaplan/compare/v5.6.7...v5.7.0

  4. v5.6.7Synaplan v5.6.72026-11-04 · 2026-11-04 09:25 UTC
    查看更新说明

    What's Changed

    Full Changelog: https://github.com/metadist/synaplan/compare/v5.6.6...v5.6.7

  5. v5.6.6Synaplan v5.6.62026-11-03 · 2026-11-03 17:30 UTC
    查看更新说明

    What's Changed

    New Contributors

    Full Changelog: https://github.com/metadist/synaplan/compare/v5.6.5...v5.6.6

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    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

    Latest release GitHub stars Discord

    Self-hosting is free. The hosted version opens with a paid plan or an invitation code – ask us at [email protected].


    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.

    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 http://localhost:5173, log in as [email protected] / 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

    WhereHowGuide
    Your machinemake up – the quickstart aboveQuickstart
    Published image, no gitOne compose.yaml, then docker compose up -dPublished image
    Docker GUIPortainer, Dockge, Synology: paste the compose file as a stackDocker GUI
    Closed networkNo route to the internet, HTTPS on your LAN addressClosed network
    Linux serverThe installer pins a release, generates secrets and runs a smoke testOn a server
    KubernetesHelm charts for clusterssynaplan-charts
    One clickRepoCloud · 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.

    SynaplanOpen WebUILibreChatDify
    What it isA team platform: chat, your files as knowledge, a site widget, and the same assistant on WhatsApp and emailA chat interface for local and cloud modelsA chat app for many providersA builder for AI apps and workflows
    First runSeveral containers, about 4 GBOne containerA Compose stackA Compose stack, and a hosted cloud
    Cost of an answerShown on the answerNot on the answerNot on the answerIn the builder's usage logs, not on the chat answer
    Same assistant on your site, WhatsApp and emailYesNoNoSite 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


    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.

    SurfaceWhat it doesGet it
    Web appFull chat and admin UI, light and dark, five languagesThis repo
    Mobile appsChat, documents and voice on iPhone and Android – on web.synaplan.com or your own serverApp Store · Google Play
    Outlook add-inFind and process mail inside Outlook (Web, new & classic, Mac) without sending it anywhereSynamail
    Chat widgetYour assistant on any website with one snippet, human takeover includedWidget guide
    WhatsApp & emailThe AI answers on the channel the question came in onWhatsApp · Email
    Nextcloud, ownCloud & OpenCloudUse your assistants inside your file cloud, with its files as knowledge – your file store stays in chargeNextcloud · ownCloud · OpenCloud
    Synaplan DesktopPair a computer and run skills on it (no installer yet – build from source)synaplan-desktop
    MCP & Claude CodeYour knowledge and memories as MCP tools, plus an Anthropic-compatible endpointMCP 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/messages endpoint and a plugin system – extend Synaplan without forking it.

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


    Troubleshooting

    ProblemWhat to do
    "Port already in use" on startA port Synaplan needs is taken – see Port conflicts
    Containers stop right after startGive Docker at least 8 GB of RAM, then check docker compose logs -f backend
    Chat gives no answersUse the Synaplan Demo, paste one provider key, or add the local-ai profile – see the quickstart
    First start seems stuckThe first start downloads all images and takes 5–15 minutes. docker compose logs -f startup-notes shows where it is
    Anything elseAsk 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.

    • 💬 Discord – the fastest place for self-hosting and configuration questions
    • 🐛 Issues – bugs and feature requests
    • 🙌 Contributing – how to get your first pull request merged (AGENTS.md is the guide for coding agents)
    • 🔒 Security policy – report a vulnerability privately

    License

    Apache-2.0 · Built in Düsseldorf by metadist · Member of the Open Source Business Alliance