AgentVault¶

AgentVault is an open-source ecosystem designed to facilitate secure and interoperable communication between AI agents (Agent-to-Agent or A2A).

This project provides libraries, tools, and specifications to enable seamless interaction in a multi-agent world.

➡️ Public Registry & UI Available!

A live instance of the AgentVault Registry API and its associated Web UI is hosted at: https://agentvault-registry-api.onrender.com

Public Discovery UI: https://agentvault-registry-api.onrender.com/ui
Developer Portal UI: https://agentvault-registry-api.onrender.com/ui/developer (Login/Register here to manage agents)
API Base: https://agentvault-registry-api.onrender.com/api/v1
Note (Cold Start): This is hosted on Render's free tier. If inactive, it may take up to 60 seconds to "wake up" on the first request. You can visit the /health endpoint or the UI to wake it up.

➡️ For detailed documentation, please visit the AgentVault Documentation Hub ⬅️

Components¶

The AgentVault monorepo contains the following key components:

agentvault_library: (Developer Guide) Core Python client library for interacting with A2A agents, managing keys, and handling protocols (A2A, MCP).
agentvault_cli: (User Guide) Command-line interface for users and developers to manage credentials, discover agents, and run tasks.
agentvault_registry: (Developer Guide) Backend API server (FastAPI) acting as the central discovery point for registered agents. Also serves a Web UI for public discovery (/ui) and developer management (/ui/developer). (Live instance available above)
agentvault_server_sdk: (Developer Guide) Python SDK to help developers build A2A-compliant agent servers easily, integrating with frameworks like FastAPI. Includes packaging tools.
agentvault_testing_utils: (Developer Guide) Shared mocks, fixtures, factories, and helpers for testing AgentVault components.
examples/: Contains practical examples demonstrating how to use the SDK and library (e.g., basic A2A server, LangChain integration). See the Examples Overview.
automation_scripts/: Scripts to automate common workflows like agent packaging and deployment.
docs/: Source files for this documentation website (built with MkDocs).

Key Protocols¶

Agent-to-Agent (A2A) Profile v0.2: Defines the core communication patterns, task lifecycle, and event streaming via JSON-RPC and SSE.
Model Context Protocol (MCP) Profile (Concept): Specifies how to embed richer context (like tool requests or user profiles) within standard A2A messages.

Installation¶

Please refer to the Installation Guide. For development setup, see the Contributing Guide.

Contributing¶

Contributions are welcome! Please see the Contributing Guide for details on setting up the development environment, running tests, and submitting changes.

License¶

AgentVault is licensed under the Apache License, Version 2.0. See the LICENSE file in the project root for details.