Extending Lobster

Build custom agent packages that integrate with the Lobster ecosystem.

Overview

Lobster's plugin architecture allows you to:

• Create domain-specific agents
• Add custom services
• Extend the CLI
• Build enterprise integrations

Getting Started

Prerequisites

• Python 3.11-3.14 (3.12+ recommended)
• uv (recommended) or pip
• Understanding of LangGraph agents

Quick Start

# Clone the template
git clone https://github.com/the-omics-os/lobster-custom-template
cd lobster-custom-template

# Rename for your package
mv lobster_custom_template lobster_custom_mypackage

# Install for development
uv pip install -e .

Plugin Contract

Your package must:

1. Register via entry points in pyproject.toml
2. Define AGENT_CONFIG at module top (before heavy imports)
3. Follow factory signature for agent creation
4. Use ServiceProtocol for service implementations

See Package Structure for details.

Resources