# sqlalchemy-seedling

> Async-native seeder & factory library

Built for SQLAlchemy 2.0+ async workflows — seed databases, generate fixtures, and run factories without the boilerplate.

## Table of Contents

### Guide

- [Getting Started](/seedling/latest/getting-started.md): Install sqlalchemy-seedling and seed your first SQLAlchemy database in five minutes.
- [Seeders](/seedling/latest/seeders.md)
- [Factories](/seedling/latest/factories.md): Define factories and AutoFactories to generate SQLAlchemy model instances for tests and seeding, with traits, descriptors, and post-generation hooks.
- [State Tracking](/seedling/latest/state-tracking.md)
- [Runner](/seedling/latest/runner.md)

### Reference

- [CLI Reference](/seedling/latest/cli.md): Full CLI reference for the sqlalchemy-seedling seed command — run, fresh, list, status, validate, graph, export, restore, init, and make subcommands.
- [Configuration](/seedling/latest/configuration.md): Configure sqlalchemy-seedling via pyproject.toml — runner settings, state tracking, and pytest plugin fixtures.

### Resources

- [Performance guide](/seedling/latest/performance.md)
- [Migrate from factory\_boy](/seedling/latest/migration.md)
- [Cookbook](/seedling/latest/cookbook.md)
- [Benchmarks](/seedling/latest/benchmarks.md)

### Other

- [For LLMs](/seedling/latest/llms.md)