Installation¶
Requirements¶
- Python 3.13 or later
- Graphviz (only required if you use the visualization features)
Installing from PyPI¶
pip¶
pip install agentspype
uv¶
uv add agentspype
poetry¶
poetry add agentspype
Dependencies¶
AgentsPype depends on the following packages, which are installed automatically:
| Package | Version | Purpose |
|---|---|---|
pydantic |
>=2.10.4, <3 | Configuration and status models |
agentspype.fsm |
built-in | Custom finite state machine engine |
pydot |
>=3.0.3, <4 | Visualization (graph generation) |
bidict |
>=0.23.1, <1 | Bidirectional mapping in Agency |
eventspype |
>=1.2.0, <2 | Event pub/sub |
Visualization Support¶
The visualization subsystem uses pydot (already a dependency) and delegates diagram rendering to Graphviz. If Graphviz is not installed, calls to agent.visualize() or other visualization methods will raise an error at the point where a PNG is written.
Install Graphviz:
macOS (Homebrew):
brew install graphviz
Ubuntu / Debian:
sudo apt-get install graphviz
Windows: Download the installer from graphviz.org/download.
Installing for Development¶
Clone the repository and install all dependency groups with uv:
git clone https://github.com/gianlucapagliara/agentspype.git
cd agentspype
uv sync --all-groups
This installs the project plus the dev and docs extras:
dev: pytest, mypy, ruff, pre-commitdocs: mkdocs
Verifying the Installation¶
import agentspype
from agentspype.agent.agent import Agent
from agentspype.agency import Agency
print("AgentsPype installed successfully")
print(f"Active agents: {Agency.get_active_agents()}")