IOA observability SDK for your multi-agentic application.
To install the package via PyPI, simply run:
pip install ioa_observe_sdkAlternatively, to download the SDK from git, you could also use the following command. Ensure you have uv installed in your environment.
uv add "git+https://github.com/agntcy/observe"The AGNTCY observability schema is an extension of the OTel LLM Semantic Conventions for Generative AI systems. This schema is designed to provide comprehensive observability for Multi-Agent Systems (MAS).
Link: AGNTCY Observability Schema
To get started with development, start a Clickhouse DB and an OTel collector container locally using docker-compose like so:
cd deploy/
docker compose up -d
Ensure the contents of otel-collector.yaml is correct.
Check the logs of the collector to ensure it is running correctly:
docker logs -f otel-collector
Create a .env file with the following content:
OTLP_HTTP_ENDPOINT=http://localhost:4318Install the dependencies and activate the virtual environment:
set -a
source .env
set +a
python3 -m venv .venv
source .venv/bin/activate
uv syncTo run the unit tests, ensure you have the OPENAI_API_KEY set in your environment. You can run the tests using the following command:
OPENAI_API_KEY=<KEY> make testFor getting started with the SDK, please refer to the Getting Started file. It contains detailed instructions on how to set up and use the SDK effectively.
Contributions are welcome! Please follow these steps to contribute:
- Fork the repository.
- Create a new branch (
git checkout -b feature-branch). - Commit your changes (
git commit -am 'Add new feature'). - Push to the branch (
git push origin feature-branch). - Create a new Pull Request.