https://github.com/synapsekit/synapsekit
Ship LLM apps faster. Production-grade LLM framework for Python. Async-native RAG, agents, and graph workflows. 2 dependencies. Zero magic.
https://github.com/synapsekit/synapsekit
agents ai anthropic async generative-ai graph-workflow langchain-alternative llm llm-framework machine-learning nlp openai pip-install python rag rag-pipeline retrieval-augmented-generation streaming synapsekit vector-database
Last synced: 3 months ago
JSON representation
Ship LLM apps faster. Production-grade LLM framework for Python. Async-native RAG, agents, and graph workflows. 2 dependencies. Zero magic.
- Host: GitHub
- URL: https://github.com/synapsekit/synapsekit
- Owner: SynapseKit
- License: apache-2.0
- Created: 2026-03-11T18:43:50.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-31T22:55:11.000Z (3 months ago)
- Last Synced: 2026-04-02T07:58:47.682Z (3 months ago)
- Topics: agents, ai, anthropic, async, generative-ai, graph-workflow, langchain-alternative, llm, llm-framework, machine-learning, nlp, openai, pip-install, python, rag, rag-pipeline, retrieval-augmented-generation, streaming, synapsekit, vector-database
- Language: Python
- Homepage: https://synapsekit.github.io/synapsekit-docs/
- Size: 1.46 MB
- Stars: 6
- Watchers: 0
- Forks: 12
- Open Issues: 108
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
[](https://pypi.org/project/synapsekit/)
[](https://www.python.org/)
[](LICENSE)
[]()
[](https://pypistats.org/packages/synapsekit)
[](https://pepy.tech/projects/synapsekit)
[](https://synapsekit.github.io/synapsekit-docs/)
[](https://discord.gg/unn4cXXH)
**[Documentation](https://synapsekit.github.io/synapsekit-docs/) · [Quickstart](https://synapsekit.github.io/synapsekit-docs/docs/getting-started/quickstart) · [API Reference](https://synapsekit.github.io/synapsekit-docs/docs/api/llm) · [Changelog](CHANGELOG.md) · [Discord](https://discord.gg/unn4cXXH) · [Report a Bug](https://github.com/SynapseKit/SynapseKit/issues/new?template=bug_report.yml)**
---
SynapseKit is an async-native Python framework for building LLM applications — RAG pipelines, tool-using agents, and graph workflows. Streaming-first, transparent API, 2 hard deps. 30 providers · 46 tools · 29 loaders · 9 vector stores. Every abstraction is composable and replaceable: plain Python you can read, debug, and extend. No magic. No hidden chains. No lock-in.
---
⚡ Async-native
Every API is async/await first.
Sync wrappers for scripts and notebooks.
No event loop surprises.
🌊 Streaming-first
Token-level streaming is the default,
not an afterthought.
Works across all providers.
🪶 Minimal footprint
2 hard dependencies: numpy + rank-bm25.
Everything else is optional.
Install only what you use.
🔌 One interface
30 LLM providers and 9 vector stores
behind the same API.
Swap without rewriting.
🧩 Composable
RAG pipelines, agents, and graph nodes
are interchangeable.
Wrap anything as anything.
🔍 Transparent
No hidden chains.
Every step is plain Python
you can read and override.
---
## Who is it for?
SynapseKit is for Python developers who want to ship LLM features without fighting their framework.
- **Backend engineers** adding AI features to existing Python services
- **ML engineers** building RAG or agent pipelines who need full control over retrieval, prompting, and tool use
- **Researchers and hackers** who want a clean, readable codebase they can understand and extend
- **Teams** who need something they can actually debug and maintain in production
---
## What it covers
**🗂 RAG Pipelines**
Retrieval-augmented generation with streaming, BM25 reranking, conversation memory, and token tracing. Load from PDFs, URLs, CSVs, HTML, directories, and more.
**🤖 Agents**
ReAct loop (any LLM) and native function calling (OpenAI / Anthropic / Gemini / Mistral). 43 built-in tools including calculator, Python REPL, web search, SQL, HTTP, shell, Twilio, arxiv, pubmed, wolfram, wikipedia, and more. Fully extensible.
**🔀 Graph Workflows**
DAG-based async pipelines. Nodes run in waves — parallel nodes execute concurrently. Conditional routing, typed state with reducers, fan-out/fan-in, SSE streaming, event callbacks, human-in-the-loop, checkpointing, and Mermaid export.
**🧠 LLM Providers**
OpenAI, Anthropic, Ollama, Gemini, Cohere, Mistral, Bedrock, Azure OpenAI, Groq, DeepSeek, OpenRouter, Together, Fireworks, Cerebras, Cloudflare, Moonshot, Perplexity, Vertex AI, Zhipu, AI21 Labs, Databricks, Baidu ERNIE, llama.cpp, Minimax, Aleph Alpha, Hugging Face, SambaNova — all behind one interface. Auto-detected from the model name. Swap without rewriting.
**🗄 Vector Stores**
InMemory (built-in, `.npz` persistence), ChromaDB, FAISS, Qdrant, Pinecone, Weaviate, PGVector, Milvus, LanceDB. One interface for all 9 backends.
**🔧 Utilities**
Output parsers (JSON, Pydantic, List), prompt templates (standard, chat, few-shot), token tracing with cost estimation.
---
## Install
**pip**
```bash
pip install synapsekit[openai] # OpenAI
pip install synapsekit[anthropic] # Anthropic
pip install synapsekit[ollama] # Ollama (local)
pip install synapsekit[all] # Everything
```
**uv**
```bash
uv add synapsekit[openai]
uv add synapsekit[all]
```
**Poetry**
```bash
poetry add synapsekit[openai]
poetry add "synapsekit[all]"
```
Full installation options → [docs](https://synapsekit.github.io/synapsekit-docs/docs/getting-started/installation)
---
## Documentation
Everything you need to get started and go deep is in the docs.
| | |
|---|---|
| 🚀 [Quickstart](https://synapsekit.github.io/synapsekit-docs/docs/getting-started/quickstart) | Up and running in 5 minutes |
| 🗂 [RAG](https://synapsekit.github.io/synapsekit-docs/docs/rag/pipeline) | Pipelines, loaders, retrieval, vector stores |
| 🤖 [Agents](https://synapsekit.github.io/synapsekit-docs/docs/agents/overview) | ReAct, function calling, tools, executor |
| 🔀 [Graph Workflows](https://synapsekit.github.io/synapsekit-docs/docs/graph/overview) | DAG pipelines, conditional routing, parallel execution |
| 🧠 [LLM Providers](https://synapsekit.github.io/synapsekit-docs/docs/llms/overview) | All 30 providers with examples |
| 📖 [API Reference](https://synapsekit.github.io/synapsekit-docs/docs/api/llm) | Full class and method reference |
---
## Development
```bash
git clone https://github.com/SynapseKit/SynapseKit
cd SynapseKit
uv sync --group dev
uv run pytest tests/ -q
```
---
## Contributing
Contributions are welcome — bug reports, documentation fixes, new providers, new features.
Read [CONTRIBUTING.md](CONTRIBUTING.md) to get started. Look for issues tagged [`good first issue`](https://github.com/SynapseKit/SynapseKit/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) if you're new.
---
## Community
- 💬 [Discussions](https://github.com/SynapseKit/SynapseKit/discussions) — ask questions, share ideas
- 🧭 [Discord roles draft](DISCORD_ROLES.md) — proposed roles and permissions for issue #389
- 🧭 [Discord release webhook draft](DISCORD_RELEASE_WEBHOOKS.md) — automate release announcements for issue #390
- 🐛 [Bug reports](https://github.com/SynapseKit/SynapseKit/issues/new?template=bug_report.yml)
- 💡 [Feature requests](https://github.com/SynapseKit/SynapseKit/issues/new?template=feature_request.yml)
- 🔒 [Security policy](SECURITY.md)
---
## Contributors
Nautiverse
💻 📖 🚧
Gordienko Andrey
💻
Deepak singh
💻
by22Jy
💻
Arjun Kundapur
💻
Harshit Gupta
📖
Dhruv Garg
💻
Adam Silva
💻
qorex
💻
---
## License
[Apache 2.0](LICENSE)