Contributing¶

Thank you for your interest in contributing to LambdaLLM!

For full contributing guidelines, see CONTRIBUTING.md on GitHub.

Quick Start for Contributors¶

# Fork and clone
git clone https://github.com/YOUR_USERNAME/lambdallm.git
cd lambdallm

# Set up dev environment
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

# Run tests
pytest tests/ -v

# Run linter
ruff check src/ tests/

Commit Convention¶

We use Conventional Commits:

feat: New feature
fix: Bug fix
docs: Documentation
test: Tests
ci: CI/CD
refactor: Refactoring

Architecture Principles¶

When contributing, keep these in mind:

Zero dependencies in core — keeps cold starts fast
Lambda-first — every feature must work within Lambda constraints
Convention over configuration — sensible defaults everywhere
Observable by default — log and trace without user config
Escape hatches — never trap the user