PkgFoundry
Catalog PyPI
Back to packageRELEASE DETAILS

0.2.1

PyPI

agent-synapse

Kubernetes-like orchestration system for AI agents

Published20 Nov 2025
Direct dependencies15
Transitive dependenciesNot calculated

README

Version 0.2.1 documentation

Synapse

Kubernetes-like orchestration system for AI agents

PyPI version License: MIT Python Version

Synapse is a powerful framework for orchestrating AI agents with Kubernetes-like semantics. It provides a simple YAML-based workflow definition and a rich CLI for managing agent-based applications.

Features

  • 🚀 Kubernetes-inspired agent orchestration
  • 📊 Built-in observability with a web dashboard
  • ⚡ Fast execution with parallel agent processing
  • 🔄 Dependency management between agents
  • 📝 YAML-based workflow definitions
  • 🔍 Tracing and logging for debugging
  • 🎨 Rich CLI with beautiful output

Installation

Install from PyPI:

pip install agent-synapse

Quick Start

  1. Initialize a new Synapse project:
synapse init

This creates an agents/ directory with demo agents (summarize.py and classify.py) and a workflow.yaml file.

  1. Run the demo workflow:
synapse run workflow.yaml --prompt "Your text here"
  1. View the dashboard (optional):
synapse serve
# Open http://localhost:8080 in your browser
  1. Modify the agents in the agents/ directory to suit your needs!

Documentation

For detailed documentation, please visit the Synapse Documentation.

Key Concepts

  • Agents: Independent units of work that process inputs and produce outputs
  • Workflows: YAML files that define the agent graph and their dependencies
  • Traces: Detailed execution logs stored in synapse_traces.db
  • Dashboard: Web UI for monitoring and debugging agent executions

Examples

Check out the examples directory for sample workflows and agent implementations.

Development

  1. Clone the repository:
git clone https://github.com/YakshithK/synapse.git
cd synapse
  1. Set up a virtual environment:
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -e ".[dev]"
  1. Run tests:
pytest

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

For support, please open an issue on GitHub.

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 15

Native requirements
15 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
typer
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.8",
  "evaluation": "NOT_EVALUATED"
}
typer>=0.9.0runtime
pyyaml
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.8",
  "evaluation": "NOT_EVALUATED"
}
pyyaml>=6.0runtime
fastapi
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.8",
  "evaluation": "NOT_EVALUATED"
}
fastapi>=0.100.0runtime
uvicorn
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.8",
  "evaluation": "NOT_EVALUATED"
}
uvicorn>=0.23.0runtime
jinja2
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.8",
  "evaluation": "NOT_EVALUATED"
}
jinja2>=3.1.0runtime
sqlalchemy
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.8",
  "evaluation": "NOT_EVALUATED"
}
sqlalchemy>=2.0.0runtime
pydantic
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.8",
  "evaluation": "NOT_EVALUATED"
}
pydantic>=2.0.0runtime
rich
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.8",
  "evaluation": "NOT_EVALUATED"
}
rich>=13.0.0runtime
bump2version
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.8",
  "evaluation": "NOT_EVALUATED"
}
bump2version>=1.0.1runtime
pytest
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.8",
  "evaluation": "NOT_EVALUATED"
}
pytest; extra == "dev"runtime
black
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.8",
  "evaluation": "NOT_EVALUATED"
}
black; extra == "dev"runtime
isort
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.8",
  "evaluation": "NOT_EVALUATED"
}
isort; extra == "dev"runtime
mypy
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.8",
  "evaluation": "NOT_EVALUATED"
}
mypy; extra == "dev"runtime
pytest-cov
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.8",
  "evaluation": "NOT_EVALUATED"
}
pytest-cov; extra == "dev"runtime
pre-commit
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.8",
  "evaluation": "NOT_EVALUATED"
}
pre-commit; extra == "dev"runtime

Distribution files

2 collected
agent_synapse-0.2.1-py3-none-any.whl

bdist_wheel · 22.1 KB · Python py3

Source file
agent_synapse-0.2.1.tar.gz

sdist · 21.09 KB · Python source

Source file

Repository

PENDING
yakshithk/synapse

Shared repository data · GitHub

License detected in repository
Not collected

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 23:31 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:2567cad27695d7063bc768acbfaede07b4faf3c9d3a7cb9fda72dc2654316fcb

Other collected versions

View all collected versions →