Contributing

Contributions welcome. The most valuable contributions are new implementations of the four pluggable layers:

  • New engines — OpenAI Agents SDK, CrewAI, Autogen adapters

  • New memory backends — Zep, Pinecone, custom vector stores

  • New observability backends — LangFuse, custom tracing integrations

  • New MCP transports — additional protocol implementations

Getting Started

  1. Read CLAUDE.md in the repository root — it has the full developer guide

  2. Check good first issue labels on GitHub

  3. Run tests before submitting:

make test && make lint

All PRs require passing integration tests.

Reporting Issues

Open an issue at https://github.com/Agent-Ship/agent-ship/issues

Please include:

  • AgentShip version or commit hash

  • Python version

  • Execution engine (ADK or LangGraph)

  • Minimal reproduction steps

  • Relevant logs (make docker-logs or dev_app.log)