AgentMsg Development

Quick Start

# Install dependencies
uv sync --extra dev

# Run locally 
uv run python -m relay.main

# Run tests
uv run pytest -v

# Build Docker image
docker build -t agentmsg .

# Run via Docker
docker run -p 8080:8080 -e RELAY_ADMIN_KEY=dev-key agentmsg

Development Workflow

1. Local development: uv run python -m relay.main (port 8080)
2. Test: uv run pytest -v
3. Commit: Git commit triggers CI/CD
4. Staging: Auto-deployed to agentmsg-staging
5. Production: Auto-deployed to agentmsg (main branch only)

Port Forwarding

From NAS to access local dev instance:

# Forward local dev to NAS port 8765
ssh -L 8765:localhost:8080 hermes-container

# Then access via http://nas-ip:8765

Testing

# Unit tests
uv run pytest tests/unit/ -v

# Integration tests  
uv run pytest tests/features/ -v

# All tests with coverage
uv run pytest --cov=relay --cov-report=html

# Load tests (TODO)
# uv run pytest tests/load/ -v

Environments

• Local: localhost:8080 (dev)
• Staging: agentmsg-staging-*.run.app (auto-deploy)
• Production: agentmsg.net (main branch only)