Quickstart - NinjaStack Docs
Description: Schema-first agentic backend framework documentation

Skip to content

# Quickstart

Build a bookstore agentic backend in under 5 minutes.

## Option A: Bolt-on to an Existing Database

    # Introspect your database
    ninjastack introspect --db postgres://localhost/bookstore

    # Review the discovered schema
    cat .ninjastack/schema.json

    # Generate the full stack
    ninjastack sync

    # Start the server
    ninjastack serve

## Option B: Design from Scratch

    from ninja_core.schema.entity import EntitySchema, FieldSchema, FieldType, StorageEngine
    from ninja_core.schema.domain import DomainSchema
    from ninja_core.schema.project import AgenticSchema

    # Define an entity
    book = EntitySchema(
        name="Book",
        storage_engine=StorageEngine.SQL,
        fields=[
            FieldSchema(name="id", field_type=FieldType.UUID, primary_key=True),
            FieldSchema(name="title", field_type=FieldType.STRING, indexed=True),
            FieldSchema(name="author", field_type=FieldType.STRING),
            FieldSchema(name="price", field_type=FieldType.FLOAT),
        ],
    )

    # Group into a domain
    catalog = DomainSchema(name="Catalog", entities=["Book"])

    # Create the project schema
    schema = AgenticSchema(
        project_name="Bookstore",
        entities=[book],
        domains=[catalog],
    )

## Option C: Conversational Setup

    ninjastack init --interactive

    # Chat with the AI assistant:
    # "I need a bookstore with books, customers, orders, and reviews.
    #  Reviews should support semantic search."

## What Gets Generated

After `ninjastack sync`, you get:

Generated | Description
--- | ---
`_generated/models/` | Pydantic models per entity
`_generated/agents/` | ADK DataAgent + DomainAgent + CoordinatorAgent
`_generated/graphql/` | Strawberry types, queries, mutations
`.ninjastack/schema.json` | Your Agentic Schema Definition

## Next Steps

- Concepts — Understand the architecture
- Examples — Walk through the full bookstore example