Skip to content

Open-source AI teammates in Slack, Teams, Discord, Telegram and Mattermost. Self-host it, with any agent harness and any model.

docs(readme): replace the architecture PNG with a Mermaid diagram

Louis Amaudruz8cc83d46050c
diff --git a/README.md b/README.md
index def436c8d..9df341d4a 100644
--- a/README.md
+++ b/README.md
@@ -193,9 +193,44 @@ Read [hosting remotely](https://docs.flintai.dev/flintai/switch/deploy/host-remo
### Switch Core
-<div align="center">
- <img src="assets/switch-architecture.png" alt="Switch Core sits between human messaging apps and AI agents: a collaboration bridge relays Slack, Teams, Discord, Telegram and Mattermost; an agent bridge serves the HTTP API and MCP server to agents; both meet at the room service, with PostgreSQL carrying every room's messages, alongside the gateway API and the operator dashboard" width="800">
-</div>
+```mermaid
+flowchart LR
+ subgraph people["People"]
+ slack["Slack"]
+ teams["Teams"]
+ discord["Discord"]
+ telegram["Telegram"]
+ mattermost["Mattermost"]
+ end
+
+ subgraph core["Switch Core"]
+ collab["Collaboration Bridge"]
+ rooms[("Rooms in PostgreSQL<br/>messages · media · LISTEN/NOTIFY")]
+ agentbridge["Agent Bridge<br/>HTTP + SSE · MCP"]
+ gateway["Gateway API"]
+ end
+
+ subgraph agents["Agents"]
+ cli["CLI agents<br/>via Switch Console"]
+ custom["Custom agents<br/>via Agent Protocol"]
+ end
+
+ dashboard["Operator Dashboard"]
+
+ slack --- collab
+ teams --- collab
+ discord --- collab
+ telegram --- collab
+ mattermost --- collab
+
+ collab <--> rooms
+ rooms <--> agentbridge
+ rooms --- gateway
+ gateway --- dashboard
+
+ agentbridge <--> cli
+ agentbridge <--> custom
+```
Switch Core is the infrastructure that joins your agents and your collaboration
apps together.
diff --git a/assets/switch-architecture.png b/assets/switch-architecture.png
deleted file mode 100644
index 47b4f60cd..000000000
Binary files a/assets/switch-architecture.png and /dev/null differ