synapse-ai

Name: synapse-ai
Author: synapseorch-ai

Verified

Build AI agents that actually do things. Synapse is an open-source platform for creating, connecting, and orchestrating AI agents powered by any LLM — local, cloud or CLIs.

313stars

55forks

Python

Installation

# Add to your Claude Code skills
git clone https://github.com/synapseorch-ai/synapse-ai

Getting Started

Guides for using ai agents skills like synapse-ai.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 5/30/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-05-30T15:57:16.197Z",
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is synapse-ai?

synapse-ai is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by synapseorch-ai. Build AI agents that actually do things. Synapse is an open-source platform for creating, connecting, and orchestrating AI agents powered by any LLM — local, cloud or CLIs. It has 313 GitHub stars.

Is synapse-ai safe to use?

Yes. synapse-ai passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install synapse-ai?

Clone the repository with "git clone https://github.com/synapseorch-ai/synapse-ai" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is synapse-ai written in?

synapse-ai is primarily written in Python. It is open-source under synapseorch-ai on GitHub, so you can review or fork the full source.

Are there alternatives to synapse-ai?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh synapse-ai against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

240,740

octo-terminal-releases mercadona-cli

⚠️ Third-Party Software Notice

This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.

Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.

Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.

Read the Terms of Service

Synapse AI — Multi-Agent Orchestration Platform

Build AI workflows that actually ship.

Wire agents, tools, and LLMs into deterministic pipelines — without the framework lock-in. Synapse is an open-source platform for creating, connecting, and orchestrating AI agents powered by any LLM — local or cloud. Agents use real tools: browsing the web, querying databases, executing code, reading files, managing emails, and anything else you can expose through an MCP server, a webhook, or a Python script.

Install

Quick Setup Script (recommended)

macOS / Linux:

curl -sSL https://raw.githubusercontent.com/synapseorch-ai/synapse-ai/main/setup.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/synapseorch-ai/synapse-ai/main/setup.ps1 | iex

npm

npm install -g synapse-orch-ai
synapse

pip

pip install synapse-orch-ai
synapse

Docker

docker run -d \
  -p 3000:3000 \
  -v synapse-data:/data \
  -v /var/run/docker.sock:/var/run/docker.sock \
  synapseorchai/synapse-ai:latest

Then open http://localhost:3000. See the Docker guide in the docs for custom ports and environment variable configuration.

Security: publish only the frontend port 3000 — the backend (8765) serves an internal API and should not be exposed on 0.0.0.0 (docker-compose binds it to 127.0.0.1). The container auto-generates a shared internal token so that surface is authenticated by default. For any network-reachable deployment, enable login (Settings → Security) and/or set allow_stdio_mcp=false, since registering a stdio MCP server launches local commands.

Upgrading

Install method	Upgrade command
Bash / PowerShell installer (recommended)	`synapse upgrade`
pip	`pip install --upgrade synapse-orch-ai`
npm	`npm update -g synapse-orch-ai`
Docker	`docker pull synapseorchai/synapse-ai:latest`

Upgrade note (security hardening): the backend now auto-generates a shared internal token and, under docker-compose, binds its port to 127.0.0.1 by default. The UI and its API are unaffected (the frontend proxies the backend internally). If you previously called the backend directly on :8765 (e.g. external API clients), either point them at the frontend instead — http://host:3000/api/v1|v2/... — or set SYNAPSE_BACKEND_BIND=0.0.0.0 in .env to keep publishing :8765.

Scale Mode

Run unlimited agents and orchestrations concurrently. When you need to go beyond a single process, the distributed scale layer handles the load:

Redis Cluster — job queue, SSE event streams, pub/sub cancellation signals, auto-failover
ARQ worker fleet — 1 to 100+ independent workers, each running up to 20 concurrent orchestrations; autoscale with KEDA on queue depth
PgBouncer — multiplexes hundreds of worker connections into a small, stable Postgres pool
S3 artifact storage — stream large file outputs directly to AWS S3, Cloudflare R2, or MinIO
Multi-tenant quotas — per-team or per-customer concurrent run limits with HTTP 429 enforcement
Per-step checkpoint recovery — worker crashes don't lose jobs; the next worker resumes from the last completed step

Three Docker images — pull only what you need:

docker pull synapseorchai/synapse-ai:latest             # full app (standalone mode)
docker pull synapseorchai/synapse-ai-api-server:latest  # stateless API server (scale mode)
docker pull synapseorchai/synapse-ai-worker:latest      # worker process (scale mode, run as many as needed)

The docker-compose.yml in the repo spins up the full stack. Production K8s manifests are in infra/k8s/.

📖 Scale Mode docs →

What Makes Synapse Different

Multi-Model Orchestrations — Run a different LLM at every step. Use a fast model for routing, a powerful one for analysis. You control where the compute goes.
Deterministic DAG Execution — Orchestrations follow the exact path you designed. No hallucinated detours.
Turn Anything Into a Tool — Python scripts, REST APIs, webhooks, MCP servers, or entire orchestrations — all become agent-callable tools.
Human-in-the-Loop — Pause workflows for human review. Resumable across restarts. Connect via UI, Slack, Telegram, or any messaging channel.
Scales to Millions of Requests — The distributed scale layer separates API servers, Redis job queues, and independent worker processes so you can run any number of agents or orchestrations concurrently. Start on one machine, grow to a Kubernetes cluster — the V2 API never changes.
Local-First, No Lock-In — Full local operation with Ollama. Mix local and cloud models freely. Your data stays yours.
Built-In Scheduling & Messaging — Cron-based automation with results pushed to Slack, Discord, Telegram, Teams, or WhatsApp.
14+ LLM Providers — Cloud, local, and CLI providers including Ollama, OpenAI, Anthropic, Gemini, xAI, DeepSeek, AWS Bedrock, and more.

📖 Learn more →

Synapse UI

https://github.com/user-attachments/assets/7a5ab42c-5fae-4f13-876c-13aa9b5a0366

Demos

Content Writing Orchestration

Multi-agent pipeline that researches a topic, drafts content in a Google Doc, and returns the shared link. (Video is 2x speed)

https://github.com/user-attachments/assets/4eec5db8-70d0-47b6-8608-f52b1f7b7d68

Autonomous Code Development & PR Creation

Multi-agent system with human-in-the-loop that writes code and generates pull requests autonomously.

https://github.com/user-attachments/assets/95a511e1-e3e9-4812-b9ca-f7f4c28ef80f

Native Orchestration Builder

Chat with the AI builder — describe what you want, and it creates the orchestration DAG for you.

https://github.com/user-attachments/assets/282cc99d-cdea-4ad0-b648-f22112c6e295

Key Concepts

Concept	Summary
Agents	Independent ReAct loops with their own system prompt, tools, model, and repos. Docs →
Orchestrations	DAGs of steps — wire agents together with routing, parallelism, loops, and human gates. Docs →
Tool Ecosystem	10+ native tool servers, built-in MCP servers, remote MCP via OAuth/PAT, and custom HTTP/Python tools. Docs →
AI Builder	A meta-agent that designs and materializes orchestrations from natural language. Docs →
Schedules	Cron/interval automation with messaging notifications. Docs →
Messaging	Slack, Discord, Telegram, Teams, WhatsApp — with multi-agent mode. Docs →
Scale Mode	Distributed execution layer: Redis job queue, independent worker fleet, per-step Postgres checkpoints, S3 artifact storage, and multi-tenant quotas. Docs →
V2 API	Stable versioned REST API for building products on top of Synapse — enqueue, stream, cancel, webhooks. Docs →
Vault	Persistent file storage shared across agents and sessions. Docs →

CLI

synapse start     # start backend + frontend, open browser
synapse stop      # stop background processes
synapse upgrade   # upgrade to the latest version
synapse uninstall # remove Synapse, wipe ~/.synapse, and uninstall the package

Roadmap

Spawn Sub-Agent Tool — Agents natively spawn and delegate tasks to temporary sub-agents mid-execution.
Compact Conversations — Automatic message history compression for large contexts.
Global Variables — Dynamic variables injectable into prompts, orchestrations, tools, and MCP environments.

Star History

[![Star History Chart](https://api.star-history.com/svg?repos=synapseorch-ai/synapse-ai&type