# BackAnt

> Official Documentation of BackAnt- a tool that enables your favorite coding agent to one-shot backends.

## Docs

- [AWS](https://docs.backant.io/apis/aws.md): Using the built-in AWSClient and boto3 for S3, Cognito, and other AWS services.
- [Architecture Concepts](https://docs.backant.io/architecture/overview.md): The four-layer architecture every BackAnt project follows — and why it matters.
- [Changelog](https://docs.backant.io/changelog.md): Release history for BackAnt CLI and MCP Server.
- [generate api](https://docs.backant.io/cli/generate-api.md): Scaffold a new BackAnt Flask API project.
- [generate route](https://docs.backant.io/cli/generate-route.md): Add a route, service, repository, and model to an existing BackAnt project.
- [generate subroute](https://docs.backant.io/cli/generate-subroute.md): Add a subroute endpoint to an existing route in a BackAnt project.
- [CLI Installation](https://docs.backant.io/cli/installation.md): Install the ant CLI and scaffold your first Flask API.
- [JSON Spec Format](https://docs.backant.io/cli/json-spec.md): The JSON specification format for generating complete BackAnt APIs.
- [CLI Overview](https://docs.backant.io/cli/overview.md): The ant CLI — global flags and command structure.
- [Database Getting Started](https://docs.backant.io/database/getting-started.md): How SQLAlchemy and PostgreSQL are set up in a BackAnt project.
- [Migrations](https://docs.backant.io/database/migrations.md): Managing database schema changes with Alembic and SQLAlchemy in BackAnt.
- [Query Builder](https://docs.backant.io/database/query-builder.md): Writing database queries with SQLAlchemy and DBSession in BackAnt repositories.
- [Seeding](https://docs.backant.io/database/seeding.md): Replacing mock data with real database logic in BackAnt.
- [Deployment](https://docs.backant.io/deployment/overview.md): Run your BackAnt project locally with Docker Compose and deploy to production via Amazon ECR.
- [Agentic Development](https://docs.backant.io/getting-started/agentic-development.md): Connect your AI coding agent to BackAnt via the MCP server.
- [Configuration](https://docs.backant.io/getting-started/configuration.md): Environment variables and database configuration for your BackAnt project.
- [Directory Structure](https://docs.backant.io/getting-started/directory-structure.md): A tour of every folder and file in a BackAnt generated project.
- [Installation](https://docs.backant.io/getting-started/installation.md): Install BackAnt and configure it for your coding agent or terminal.
- [MCP Server](https://docs.backant.io/getting-started/mcp-server.md): Install and configure the BackAnt MCP server for your coding agent.
- [Welcome to BackAnt](https://docs.backant.io/index.md): AI-native backend generator.
- [Architecture (light)](https://docs.backant.io/kairos/architecture.md): Enough technical hints to evaluate the design — not enough to recreate it.
- [Configuration](https://docs.backant.io/kairos/configuration.md): The .backant.toml file controls per-project policy: what Kairos can do, where it can do it, and what it costs.
- [Daily use](https://docs.backant.io/kairos/daily-use.md): Start, stop, watch, and inspect Kairos during day-to-day operation.
- [Dream pass](https://docs.backant.io/kairos/dream.md): Inspect Kairos's offline consolidation pipeline.
- [Eval reports](https://docs.backant.io/kairos/eval.md): Weekly compliance, cost, and outcome reports — plus a small simulated-scenario replay to catch silent regressions.
- [Installation](https://docs.backant.io/kairos/installation.md): Install Kairos and walk through the first-run setup wizard.
- [Memory](https://docs.backant.io/kairos/memory.md): Inspect and manage the local memory store. Recall is automatic during normal work — these commands are for introspection.
- [Overview](https://docs.backant.io/kairos/overview.md): Kairos is an autonomous Claude Code harness. Keep Claude Code working on your repo around the clock — with memory that survives across sessions.
- [Privacy and data](https://docs.backant.io/kairos/privacy.md): Exactly what lives where, and what does or does not leave your machine.
- [Troubleshooting](https://docs.backant.io/kairos/troubleshooting.md): Common failure modes and how to fix them.
- [Authentication](https://docs.backant.io/security/authentication.md): Protecting routes with Bearer token authentication in BackAnt.
- [Authorization](https://docs.backant.io/security/authorization.md): Role-based access control with the role_required decorator.
- [Encryption & Hashing](https://docs.backant.io/security/encryption.md): JWT handling, API key hashing, and Cognito integration in BackAnt.
- [Controllers](https://docs.backant.io/the-basics/controllers.md): Routes act as controllers in BackAnt — thin HTTP handlers that delegate everything to the service layer.
- [Error Handling](https://docs.backant.io/the-basics/error-handling.md): Raising and handling API errors with APIException in BackAnt.
- [Logging](https://docs.backant.io/the-basics/logging.md): Structured logging with the BackAnt Logger class.
- [Middleware](https://docs.backant.io/the-basics/middleware.md): CORS, session teardown, and graceful shutdown in BackAnt.
- [Requests](https://docs.backant.io/the-basics/requests.md): Reading HTTP request data in BackAnt routes.
- [Responses](https://docs.backant.io/the-basics/responses.md): Returning JSON responses and HTTP status codes from BackAnt routes.
- [Routing](https://docs.backant.io/the-basics/routing.md): How Flask Blueprints and URL routing work in a BackAnt project.
- [Schemas](https://docs.backant.io/the-basics/schemas.md): Request validation with marshmallow schemas in BackAnt.

## Optional

- [GitHub](https://github.com/backant)
- [Support](mailto:support@backant.io)