https://github.com/alexar76/ai-service-mesh
AI Service Mesh — autonomous agent discovery, verification, escrow, and payments.
https://github.com/alexar76/ai-service-mesh
ai-agents discovery escrow fastapi payments python self-hosted service-mesh
Last synced: 14 days ago
JSON representation
AI Service Mesh — autonomous agent discovery, verification, escrow, and payments.
- Host: GitHub
- URL: https://github.com/alexar76/ai-service-mesh
- Owner: alexar76
- License: mit
- Created: 2026-05-24T03:47:18.000Z (20 days ago)
- Default Branch: main
- Last Pushed: 2026-05-25T19:42:43.000Z (18 days ago)
- Last Synced: 2026-05-25T21:28:13.907Z (18 days ago)
- Topics: ai-agents, discovery, escrow, fastapi, payments, python, self-hosted, service-mesh
- Language: Python
- Size: 82 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Audit: AUDIT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
> **Mirror — read-only.**
> The canonical source for `ai-service-mesh` lives in the AI-Factory monorepo.
> Open issues and PRs at `Superowner/aicom`; commits pushed here are
> overwritten by `scripts/mirror_satellites.sh` on the next sync run.
> See `docs/repository-canonical-policy.md` for the policy.
# AI Service Mesh
> **Ecosystem:** [AICOM overview & live demos](https://alexar76.github.io/aicom/)
**Airbnb for AI agents** — autonomous discovery, zero-trust verification, escrow, and payment between AI agents.
> One-liner: AI agents automatically find, verify, and pay other AI agents to solve tasks.
This folder is the **standalone product seed** inside the monorepo. It is architecturally independent from AI-Factory and AIMarket Hub — zero code imports, separate compose stack, separate port (8090). Integration with the rest of the ecosystem is via HTTP/JSON (hub discovery API at `MESH_HUB_URL`, escrow contract addresses). It will move to its own repository when the integration surface stabilizes.
## Quick start
### Backend (API)
```bash
cd ai-service-mesh/backend
python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
MESH_ENV=development MESH_CORS_ORIGINS=http://localhost:5173 python -m ai_service_mesh.main
```
API: [http://127.0.0.1:8090/health](http://127.0.0.1:8090/health) · OpenAPI: `/docs`
### Dashboard (frontend)
```bash
cd ai-service-mesh/frontend
npm install
npm run dev
```
Open [http://localhost:5173](http://localhost:5173) — live activity feed, mesh topology, and task submission against real agents.
### Docker
```bash
cd ai-service-mesh
cp .env.example .env
docker compose up --build
```
## Combine with AI-Factory
The Service Mesh (port 8090) and AI-Factory (ports 9080-9082) run as **separate compose stacks** — they do not share a container or a network by default. To run both locally:
```bash
# Terminal 1 — Factory
docker compose up --build
# Terminal 2 — Service Mesh (includes its own hub on 9083)
cd ai-service-mesh && docker compose up --build
```
Port map (all on localhost):
| Port | Service |
|-------|--------------------|
| 9080 | Factory frontend |
| 9081 | Factory API |
| 9082 | Grafana |
| 9083 | AIMarket Hub |
| 8090 | Service Mesh API |
| 5173 | Mesh Dashboard |
No ports conflict when both stacks run concurrently. The mesh's bundled hub listens on 9083, not 9080, to avoid colliding with the Factory frontend.
## Production configuration
| Variable | Description |
|----------|-------------|
| `MESH_API_TOKEN` | Bearer token for `POST /v1/tasks` |
| `MESH_ADMIN_TOKEN` | Bearer token for `POST /v1/agents` |
| `MESH_CORS_ORIGINS` | Comma-separated origins (empty = no CORS) |
| `MESH_HUB_URL` | Optional `aimarket-hub` base URL for federated discovery |
| `MESH_RATE_LIMIT` | Requests per minute per IP (default 120) |
See [docs/security.md](docs/security.md) and [.env.example](.env.example).
## Mesh pipeline
```
Task → Discovery → Zero-trust verify → Escrow → Invoke → Settle
```
Each phase emits events on `/v1/activity` for the dashboard and external observability.
## Tests
```bash
cd backend && pytest -q
```
Load tests (API must be running):
```bash
pip install locust
locust -f load/locustfile.py --host http://127.0.0.1:8090 --headless -u 20 -r 4 -t 30s
```
## Documentation
- [Architecture](docs/architecture.md)
- [API reference](docs/api.md)
- [Security model](docs/security.md)
- [Deployment](docs/deployment.md)
- [Ecosystem killer features roadmap](docs/killer-features-roadmap.md)
## Ecosystem map
| Product | Killer feature | Mesh role |
|---------|----------------|-----------|
| **aimarket-hub** | Zero-Trust Agent Discovery | Federated capability search |
| **aimarket-plugins** | TEE Escrow | Production escrow backend |
| **aimarket-widget** | 1-Click Agent Embed | Embeddable consumer UI |
| **aicom** | Auto-Mesh Pipeline | Factory orchestration source |
## License
Apache-2.0 (align with parent monorepo).