Skip to content

Configuration

All available options when generating a project.

Core Options

Option Values Description
--database postgresql, mongodb, sqlite Database backend (async by default)
--orm sqlalchemy, sqlmodel ORM choice (SQLModel for simplified syntax)
--oauth none, google OAuth2 social login
--ai-framework pydantic_ai, pydantic_deep, langchain, langgraph, crewai, deepagents AI agent framework
--llm-provider openai, anthropic, google, openrouter LLM provider
--background-tasks none, celery, taskiq, arq Background task queue
--frontend none, nextjs Frontend framework

Presets

Bash
# Full production setup
fastapi-fullstack create my_app --preset production

# AI agent with streaming
fastapi-fullstack create my_app --preset ai-agent

# Minimal project
fastapi-fullstack create my_app --minimal

AI Framework Options

Framework Providers Description
pydantic_ai OpenAI, Anthropic, Google, OpenRouter Type-safe agents with WebSearch/WebFetch built-in
pydantic_deep OpenAI, Anthropic, Google Deep coding assistant (filesystem tools, Docker/Daytona sandbox)
langchain OpenAI, Anthropic, Google Comprehensive chain-based agents
langgraph OpenAI, Anthropic, Google Graph-based ReAct agents
crewai OpenAI, Anthropic, Google Multi-agent orchestration
deepagents OpenAI, Anthropic, Google Agentic framework with subagent delegation
Bash
fastapi-fullstack create my_app --ai-framework pydantic_ai --llm-provider openai
fastapi-fullstack create my_app --ai-framework pydantic_deep --llm-provider anthropic
fastapi-fullstack create my_app --ai-framework langgraph --llm-provider google

Database Options

Bash
fastapi-fullstack create my_app --database postgresql
  • Async via asyncpg
  • Connection pooling
  • Full SQL features

MongoDB

Bash
fastapi-fullstack create my_app --database mongodb
  • Async via Motor
  • Beanie ODM
  • Flexible schema

Messaging Channels

Enable Telegram and/or Slack multi-bot integration via the interactive wizard (fastapi-fullstack new).

Platform Mode Feature
Telegram Polling (dev) Long-polling via aiogram v3 Socket Mode
Telegram Webhook (prod) POST /telegram/{bot_id}/webhook with HMAC verification
Slack Socket Mode (dev) slack-sdk Socket Mode for development
Slack Events API (prod) POST /slack/{bot_id}/events with HMAC-SHA256 signature

Both platforms share the same underlying infrastructure:

  • Multi-bot — Multiple bots per platform, each with encrypted token storage (Fernet)
  • Per-thread sessions — Telegram replies + Slack thread_ts each get their own ChannelSession
  • Group concurrency — Per-chat asyncio.Lock prevents interleaved agent calls in group chats
  • Access policies — open, whitelist, jwt_linked, group_only
  • Commands — /start, /new, /help, /link, /unlink
  • Identity linking — Connect Telegram/Slack user to an app account via one-time link code

Environment Variables (Telegram)

Bash
TELEGRAM_WEBHOOK_BASE_URL=https://yourdomain.com  # for webhook mode
CHANNEL_ENCRYPTION_KEY=...  # Fernet key for token storage

Environment Variables (Slack)

Bash
SLACK_SIGNING_SECRET=...    # From Slack app settings (Events API verification)
SLACK_BOT_TOKEN=xoxb-...    # Bot OAuth token (for sending messages)
SLACK_APP_TOKEN=xapp-...    # App-level token (for Socket Mode dev)
CHANNEL_ENCRYPTION_KEY=...  # Fernet key for token storage

Integrations

Enable during project generation:

Bash
fastapi-fullstack new
# ✓ Redis (caching/sessions)
# ✓ Rate limiting (slowapi)
# ✓ Pagination
# ✓ Admin Panel (SQLAdmin)
# ✓ Webhooks
# ✓ Telegram integration
# ✓ Slack integration
# ✓ Sentry
# ✓ Logfire / LangSmith
# ✓ Prometheus

Environment Variables

Generated projects use .env files:

Bash
# Database
DATABASE_URL=postgresql+asyncpg://user:pass@localhost/db

# Auth
JWT_SECRET_KEY=your-secret-key
JWT_ALGORITHM=HS256

# AI
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GOOGLE_API_KEY=...

# Messaging channels (if enabled)
CHANNEL_ENCRYPTION_KEY=...           # Fernet key: python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"
TELEGRAM_WEBHOOK_BASE_URL=https://...  # Telegram webhook mode only
SLACK_SIGNING_SECRET=...             # Slack Events API signature verification
SLACK_BOT_TOKEN=xoxb-...             # Slack Web API
SLACK_APP_TOKEN=xapp-...             # Slack Socket Mode (dev only)

# Observability
LOGFIRE_TOKEN=...
SENTRY_DSN=...

Next Steps