Installation

Requirements

Python 3.11 or higher
uv (recommended) or pip

Quick Install

# uv (recommended — fast, deterministic)
uv add lexigram

# pip
pip install lexigram

The core lexigram package gives you:

Feature	Import	Description
`Application`	`lexigram.Application`	Composition root with lifecycle management
`Provider`	`lexigram.Provider`	Two-phase `register` / `boot` service wiring
`Container`	`lexigram.Container`	IoC container — `singleton`, `scoped`, `transient` bindings
DI Decorators	`lexigram.singleton`, `lexigram.injectable`	`@singleton`, `@injectable`, `@scoped`, `@transient`
`LexigramConfig`	`lexigram.LexigramConfig`	YAML + env vars + profile overlays
`Result`	`lexigram.Result`, `lexigram.Ok`, `lexigram.Err`	Result pattern with `unwrap`, `map`, `and_then`
`Module`	`lexigram.Module`	`@module` decorator with import/export boundaries
Contracts	`lexigram_contracts`	Base protocols (auto-installed)

Common Stacks

Install only what you need. Every package depends only on lexigram (core) and lexigram-contracts.

Web API

uv add lexigram-web

Starlette-based web layer — controllers, routing, middleware, OpenAPI docs, CORS, CSRF, rate limiting.

Database

uv add lexigram-sql

Async ORM, migrations, repository pattern.

AI Agents

uv add lexigram-ai-agents

Agent framework with tools, strategies (ReAct, PlanAndExecute), and governance.

All Packages

Category	Packages
Core	`lexigram`, `lexigram-contracts`
Web & API	`lexigram-web`, `lexigram-http`, `lexigram-graphql`
Security	`lexigram-auth`, `lexigram-security`
Data & Storage	`lexigram-sql`, `lexigram-cache`, `lexigram-storage`, `lexigram-search`
Events & Messaging	`lexigram-events`, `lexigram-queue`, `lexigram-notification`
AI	`lexigram-ai`, `lexigram-ai-llm`, `lexigram-ai-rag`, `lexigram-ai-agents`, `lexigram-ai-memory`
Resilience	`lexigram-resilience`, `lexigram-idempotency`
Observability	`lexigram-monitor`, `lexigram-ai-observability`
Tasks & Workflow	`lexigram-tasks`, `lexigram-workflow`
Utilities	`lexigram-testing`, `lexigram-cli`, `lexigram-features`

Developer Tools

# CLI — project scaffolding, code generation, dev server
uv add lexigram-cli

# Testing — fakes, test containers, compliance suites
uv add --dev lexigram-testing

Verify Installation

python -c "import lexigram; print(lexigram.__version__)"

Next Steps

Your First App — Build a working API in under 10 lines
Project Structure — Recommended layouts
Core Concepts — Providers, DI, Result type, and modules