agentgatesh 0.1.0__tar.gz

agentgatesh-0.1.0/.env.example

@@ -0,0 +1,16 @@
+# AgentGate Configuration
+# Copy this to .env and fill in your values
+
+# Database
+DATABASE_URL=postgresql+asyncpg://agentgate:changeme@localhost:5432/agentgate
+
+# Server
+HOST=0.0.0.0
+PORT=8000
+DEBUG=true
+
+# Security (generate with: python -c "import secrets; print(secrets.token_hex(32))")
+SECRET_KEY=changeme
+
+# API key for deploy authentication (generate with: python -c "import secrets; print(secrets.token_hex(32))")
+API_KEY=

agentgatesh-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,32 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Lint
+        run: uv run --extra dev ruff check src/ tests/
+
+      - name: Test
+        run: uv run --extra dev pytest -v

agentgatesh-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,29 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: uv python install 3.12
+      - run: uv sync --extra dev
+      - run: uv run --extra dev ruff check src/ tests/
+      - run: uv run --extra dev pytest -v
+
+  publish:
+    needs: test
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: uv build
+      - uses: pypa/gh-action-pypi-publish@release/v1

agentgatesh-0.1.0/.gitignore

@@ -0,0 +1,38 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.venv/
+*.egg
+
+# Environment
+.env
+.env.local
+.env.production
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Docker
+docker-compose.override.yml
+
+# Testing
+.coverage
+htmlcov/
+.pytest_cache/
+
+# Alembic
+*.db
+
+# Memory files (project-specific, not for public repo)
+memory/
+CLAUDE.md

agentgatesh-0.1.0/Dockerfile

@@ -0,0 +1,24 @@
+FROM python:3.12-slim
+
+WORKDIR /app
+
+# Install uv
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /usr/local/bin/uv
+
+# Copy dependency files first (better caching)
+COPY pyproject.toml uv.lock ./
+
+# Install dependencies
+RUN uv sync --frozen --no-dev --no-install-project
+
+# Copy source code and README (required by hatchling build)
+COPY README.md ./
+COPY src/ src/
+COPY alembic.ini entrypoint.sh ./
+
+# Install the project itself
+RUN uv sync --frozen --no-dev
+
+EXPOSE 8000
+
+CMD ["./entrypoint.sh"]

agentgatesh-0.1.0/PKG-INFO

@@ -0,0 +1,182 @@
+Metadata-Version: 2.4
+Name: agentgatesh
+Version: 0.1.0
+Summary: The unified gateway to deploy, connect, and monetize AI agents via MCP + A2A + UCP.
+Author-email: AgentGate <info@agentgate.sh>
+License-Expression: AGPL-3.0-or-later
+Keywords: a2a,agents,ai,deploy,gateway,mcp
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.11
+Requires-Dist: alembic>=1.14.0
+Requires-Dist: asyncpg>=0.30.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: sqlalchemy[asyncio]>=2.0.0
+Requires-Dist: uvicorn[standard]>=0.34.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# AgentGate
+
+The unified gateway to deploy, connect, and monetize AI agents via MCP + A2A + UCP.
+
+[![CI](https://github.com/agentgatesh/agentgate/actions/workflows/ci.yml/badge.svg)](https://github.com/agentgatesh/agentgate/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/agentgatesh)](https://pypi.org/project/agentgatesh/)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org/)
+[![License: AGPL-3.0](https://img.shields.io/badge/license-AGPL--3.0-green)](LICENSE)
+
+## What is AgentGate?
+
+AgentGate is an open-source gateway that makes it easy to deploy, discover, and connect AI agents using standard protocols (MCP, A2A, UCP). Think of it as **Vercel + npm + Stripe, but for AI agents**.
+
+- **Deploy in 5 minutes** — One command, your agent is live with an A2A-compliant Agent Card
+- **Registry & Discovery** — Find agents by capability via `.well-known/agent.json`
+- **Built-in Monetization** — Your agent can charge for its services (coming soon)
+
+## Quick Start
+
+### 1. Install
+
+```bash
+pip install agentgatesh
+```
+
+### 2. Create your agent config
+
+```bash
+mkdir my-agent && cd my-agent
+cat > agentgate.yaml << 'EOF'
+name: my-agent
+description: A helpful AI agent
+url: https://my-agent.example.com
+version: 1.0.0
+skills:
+  - id: chat
+    name: Chat
+    description: General conversation
+EOF
+```
+
+### 3. Deploy
+
+```bash
+export AGENTGATE_API_KEY=your-api-key
+agentgate deploy ./my-agent
+```
+
+Your agent is now live with an A2A-compliant Agent Card.
+
+### 4. Verify
+
+```bash
+agentgate list
+agentgate status
+```
+
+## CLI Reference
+
+| Command | Description |
+|---------|-------------|
+| `agentgate status` | Show server status |
+| `agentgate list` | List all deployed agents |
+| `agentgate deploy ./path` | Deploy an agent from a directory |
+| `agentgate update <agent-id>` | Update an agent (--name, --version, etc.) |
+| `agentgate delete <agent-id>` | Delete a deployed agent |
+
+All commands that modify data require `--api-key` or the `AGENTGATE_API_KEY` environment variable.
+
+## Python SDK
+
+```python
+from agentgate.sdk import AgentGateClient
+
+# Connect to AgentGate
+client = AgentGateClient("https://agentgate.sh", api_key="your-key")
+
+# List agents
+agents = client.list_agents()
+
+# Register a new agent
+agent = client.register_agent(
+    name="my-agent",
+    url="https://my-agent.example.com",
+    description="A helpful agent",
+)
+
+# Send a task to an agent (A2A routing via AgentGate)
+result = client.send_task(agent["id"], "Hello, agent!")
+print(result["artifacts"][0]["parts"][0]["text"])
+
+# Update an agent
+client.update_agent(agent["id"], version="2.0.0")
+
+# Delete an agent
+client.delete_agent(agent["id"])
+
+# Context manager for automatic cleanup
+with AgentGateClient("https://agentgate.sh") as c:
+    print(c.health())
+```
+
+## API Endpoints
+
+| Method | Path | Auth | Description |
+|--------|------|------|-------------|
+| `GET` | `/health` | No | Server health check |
+| `GET` | `/` | No | Landing page |
+| `GET` | `/.well-known/agent.json` | No | A2A discovery endpoint |
+| `GET` | `/agents/` | No | List all agents |
+| `GET` | `/agents/{id}` | No | Get agent details |
+| `GET` | `/agents/{id}/card` | No | Get A2A Agent Card |
+| `POST` | `/agents/` | Yes | Register a new agent |
+| `PUT` | `/agents/{id}` | Yes | Update an agent |
+| `DELETE` | `/agents/{id}` | Yes | Delete an agent |
+| `POST` | `/agents/{id}/task` | No | Route A2A task to agent (rate limited) |
+| `GET` | `/metrics` | No | Task routing metrics |
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/agentgatesh/agentgate.git
+cd agentgate
+
+# Install dependencies (requires uv)
+uv sync --dev
+
+# Run tests
+uv run pytest -v
+
+# Lint
+uv run ruff check src/ tests/
+
+# Start services locally
+docker compose up -d
+
+# Check status
+uv run agentgate status --server http://localhost:8000
+```
+
+## Architecture
+
+- **Framework**: FastAPI + Uvicorn
+- **Database**: PostgreSQL 16 + SQLAlchemy async + Alembic
+- **CLI**: Click
+- **Packaging**: uv + hatchling
+- **Deploy**: Docker Compose + Caddy reverse proxy
+
+## License
+
+AGPL-3.0 — see [LICENSE](LICENSE) for details.

agentgatesh-0.1.0/README.md

@@ -0,0 +1,152 @@
+# AgentGate
+
+The unified gateway to deploy, connect, and monetize AI agents via MCP + A2A + UCP.
+
+[![CI](https://github.com/agentgatesh/agentgate/actions/workflows/ci.yml/badge.svg)](https://github.com/agentgatesh/agentgate/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/agentgatesh)](https://pypi.org/project/agentgatesh/)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org/)
+[![License: AGPL-3.0](https://img.shields.io/badge/license-AGPL--3.0-green)](LICENSE)
+
+## What is AgentGate?
+
+AgentGate is an open-source gateway that makes it easy to deploy, discover, and connect AI agents using standard protocols (MCP, A2A, UCP). Think of it as **Vercel + npm + Stripe, but for AI agents**.
+
+- **Deploy in 5 minutes** — One command, your agent is live with an A2A-compliant Agent Card
+- **Registry & Discovery** — Find agents by capability via `.well-known/agent.json`
+- **Built-in Monetization** — Your agent can charge for its services (coming soon)
+
+## Quick Start
+
+### 1. Install
+
+```bash
+pip install agentgatesh
+```
+
+### 2. Create your agent config
+
+```bash
+mkdir my-agent && cd my-agent
+cat > agentgate.yaml << 'EOF'
+name: my-agent
+description: A helpful AI agent
+url: https://my-agent.example.com
+version: 1.0.0
+skills:
+  - id: chat
+    name: Chat
+    description: General conversation
+EOF
+```
+
+### 3. Deploy
+
+```bash
+export AGENTGATE_API_KEY=your-api-key
+agentgate deploy ./my-agent
+```
+
+Your agent is now live with an A2A-compliant Agent Card.
+
+### 4. Verify
+
+```bash
+agentgate list
+agentgate status
+```
+
+## CLI Reference
+
+| Command | Description |
+|---------|-------------|
+| `agentgate status` | Show server status |
+| `agentgate list` | List all deployed agents |
+| `agentgate deploy ./path` | Deploy an agent from a directory |
+| `agentgate update <agent-id>` | Update an agent (--name, --version, etc.) |
+| `agentgate delete <agent-id>` | Delete a deployed agent |
+
+All commands that modify data require `--api-key` or the `AGENTGATE_API_KEY` environment variable.
+
+## Python SDK
+
+```python
+from agentgate.sdk import AgentGateClient
+
+# Connect to AgentGate
+client = AgentGateClient("https://agentgate.sh", api_key="your-key")
+
+# List agents
+agents = client.list_agents()
+
+# Register a new agent
+agent = client.register_agent(
+    name="my-agent",
+    url="https://my-agent.example.com",
+    description="A helpful agent",
+)
+
+# Send a task to an agent (A2A routing via AgentGate)
+result = client.send_task(agent["id"], "Hello, agent!")
+print(result["artifacts"][0]["parts"][0]["text"])
+
+# Update an agent
+client.update_agent(agent["id"], version="2.0.0")
+
+# Delete an agent
+client.delete_agent(agent["id"])
+
+# Context manager for automatic cleanup
+with AgentGateClient("https://agentgate.sh") as c:
+    print(c.health())
+```
+
+## API Endpoints
+
+| Method | Path | Auth | Description |
+|--------|------|------|-------------|
+| `GET` | `/health` | No | Server health check |
+| `GET` | `/` | No | Landing page |
+| `GET` | `/.well-known/agent.json` | No | A2A discovery endpoint |
+| `GET` | `/agents/` | No | List all agents |
+| `GET` | `/agents/{id}` | No | Get agent details |
+| `GET` | `/agents/{id}/card` | No | Get A2A Agent Card |
+| `POST` | `/agents/` | Yes | Register a new agent |
+| `PUT` | `/agents/{id}` | Yes | Update an agent |
+| `DELETE` | `/agents/{id}` | Yes | Delete an agent |
+| `POST` | `/agents/{id}/task` | No | Route A2A task to agent (rate limited) |
+| `GET` | `/metrics` | No | Task routing metrics |
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/agentgatesh/agentgate.git
+cd agentgate
+
+# Install dependencies (requires uv)
+uv sync --dev
+
+# Run tests
+uv run pytest -v
+
+# Lint
+uv run ruff check src/ tests/
+
+# Start services locally
+docker compose up -d
+
+# Check status
+uv run agentgate status --server http://localhost:8000
+```
+
+## Architecture
+
+- **Framework**: FastAPI + Uvicorn
+- **Database**: PostgreSQL 16 + SQLAlchemy async + Alembic
+- **CLI**: Click
+- **Packaging**: uv + hatchling
+- **Deploy**: Docker Compose + Caddy reverse proxy
+
+## License
+
+AGPL-3.0 — see [LICENSE](LICENSE) for details.

agentgatesh-0.1.0/alembic.ini

@@ -0,0 +1,149 @@
+# A generic, single database configuration.
+
+[alembic]
+# path to migration scripts.
+# this is typically a path given in POSIX (e.g. forward slashes)
+# format, relative to the token %(here)s which refers to the location of this
+# ini file
+script_location = %(here)s/src/agentgate/db/migrations
+
+# template used to generate migration file names; The default value is %%(rev)s_%%(slug)s
+# Uncomment the line below if you want the files to be prepended with date and time
+# see https://alembic.sqlalchemy.org/en/latest/tutorial.html#editing-the-ini-file
+# for all available tokens
+# file_template = %%(year)d_%%(month).2d_%%(day).2d_%%(hour).2d%%(minute).2d-%%(rev)s_%%(slug)s
+# Or organize into date-based subdirectories (requires recursive_version_locations = true)
+# file_template = %%(year)d/%%(month).2d/%%(day).2d_%%(hour).2d%%(minute).2d_%%(second).2d_%%(rev)s_%%(slug)s
+
+# sys.path path, will be prepended to sys.path if present.
+# defaults to the current working directory.  for multiple paths, the path separator
+# is defined by "path_separator" below.
+prepend_sys_path = . src
+
+
+# timezone to use when rendering the date within the migration file
+# as well as the filename.
+# If specified, requires the tzdata library which can be installed by adding
+# `alembic[tz]` to the pip requirements.
+# string value is passed to ZoneInfo()
+# leave blank for localtime
+# timezone =
+
+# max length of characters to apply to the "slug" field
+# truncate_slug_length = 40
+
+# set to 'true' to run the environment during
+# the 'revision' command, regardless of autogenerate
+# revision_environment = false
+
+# set to 'true' to allow .pyc and .pyo files without
+# a source .py file to be detected as revisions in the
+# versions/ directory
+# sourceless = false
+
+# version location specification; This defaults
+# to <script_location>/versions.  When using multiple version
+# directories, initial revisions must be specified with --version-path.
+# The path separator used here should be the separator specified by "path_separator"
+# below.
+# version_locations = %(here)s/bar:%(here)s/bat:%(here)s/alembic/versions
+
+# path_separator; This indicates what character is used to split lists of file
+# paths, including version_locations and prepend_sys_path within configparser
+# files such as alembic.ini.
+# The default rendered in new alembic.ini files is "os", which uses os.pathsep
+# to provide os-dependent path splitting.
+#
+# Note that in order to support legacy alembic.ini files, this default does NOT
+# take place if path_separator is not present in alembic.ini.  If this
+# option is omitted entirely, fallback logic is as follows:
+#
+# 1. Parsing of the version_locations option falls back to using the legacy
+#    "version_path_separator" key, which if absent then falls back to the legacy
+#    behavior of splitting on spaces and/or commas.
+# 2. Parsing of the prepend_sys_path option falls back to the legacy
+#    behavior of splitting on spaces, commas, or colons.
+#
+# Valid values for path_separator are:
+#
+# path_separator = :
+# path_separator = ;
+# path_separator = space
+# path_separator = newline
+#
+# Use os.pathsep. Default configuration used for new projects.
+path_separator = os
+
+# set to 'true' to search source files recursively
+# in each "version_locations" directory
+# new in Alembic version 1.10
+# recursive_version_locations = false
+
+# the output encoding used when revision files
+# are written from script.py.mako
+# output_encoding = utf-8
+
+# database URL.  This is consumed by the user-maintained env.py script only.
+# other means of configuring database URLs may be customized within the env.py
+# file.
+sqlalchemy.url = driver://user:pass@localhost/dbname
+
+
+[post_write_hooks]
+# post_write_hooks defines scripts or Python functions that are run
+# on newly generated revision scripts.  See the documentation for further
+# detail and examples
+
+# format using "black" - use the console_scripts runner, against the "black" entrypoint
+# hooks = black
+# black.type = console_scripts
+# black.entrypoint = black
+# black.options = -l 79 REVISION_SCRIPT_FILENAME
+
+# lint with attempts to fix using "ruff" - use the module runner, against the "ruff" module
+# hooks = ruff
+# ruff.type = module
+# ruff.module = ruff
+# ruff.options = check --fix REVISION_SCRIPT_FILENAME
+
+# Alternatively, use the exec runner to execute a binary found on your PATH
+# hooks = ruff
+# ruff.type = exec
+# ruff.executable = ruff
+# ruff.options = check --fix REVISION_SCRIPT_FILENAME
+
+# Logging configuration.  This is also consumed by the user-maintained
+# env.py script only.
+[loggers]
+keys = root,sqlalchemy,alembic
+
+[handlers]
+keys = console
+
+[formatters]
+keys = generic
+
+[logger_root]
+level = WARNING
+handlers = console
+qualname =
+
+[logger_sqlalchemy]
+level = WARNING
+handlers =
+qualname = sqlalchemy.engine
+
+[logger_alembic]
+level = INFO
+handlers =
+qualname = alembic
+
+[handler_console]
+class = StreamHandler
+args = (sys.stderr,)
+level = NOTSET
+formatter = generic
+
+[formatter_generic]
+format = %(levelname)-5.5s [%(name)s] %(message)s
+datefmt = %H:%M:%S

agentgatesh-0.1.0/docker-compose.yml

@@ -0,0 +1,45 @@
+services:
+  db:
+    image: postgres:16-alpine
+    restart: unless-stopped
+    environment:
+      POSTGRES_USER: agentgate
+      POSTGRES_PASSWORD: ${DB_PASSWORD:-changeme}
+      POSTGRES_DB: agentgate
+    volumes:
+      - pgdata:/var/lib/postgresql/data
+    ports:
+      - "127.0.0.1:5432:5432"
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U agentgate"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+  api:
+    build: .
+    restart: unless-stopped
+    depends_on:
+      db:
+        condition: service_healthy
+    environment:
+      DATABASE_URL: postgresql+asyncpg://agentgate:${DB_PASSWORD:-changeme}@db:5432/agentgate
+      SECRET_KEY: ${SECRET_KEY:-changeme}
+      API_KEY: ${API_KEY}
+    ports:
+      - "127.0.0.1:8000:8000"
+
+  echo-agent:
+    build: examples/echo-agent
+    restart: unless-stopped
+    ports:
+      - "127.0.0.1:9000:9000"
+
+  calc-agent:
+    build: examples/calc-agent
+    restart: unless-stopped
+    ports:
+      - "127.0.0.1:9001:9001"
+
+volumes:
+  pgdata:

agentgatesh-0.1.0/entrypoint.sh

@@ -0,0 +1,4 @@
+#!/bin/sh
+set -e
+uv run alembic upgrade head
+exec uv run uvicorn agentgate.server.app:app --host 0.0.0.0 --port 8000

agentgatesh-0.1.0/examples/calc-agent/Dockerfile

@@ -0,0 +1,6 @@
+FROM python:3.12-slim
+WORKDIR /app
+RUN pip install --no-cache-dir fastapi uvicorn
+COPY agent.py .
+EXPOSE 9001
+CMD ["uvicorn", "agent:app", "--host", "0.0.0.0", "--port", "9001"]