lich init¶

Create a new Lich Toolkit project with interactive prompts.

Usage¶

lich init [OPTIONS]

What It Does¶

Asks project configuration questions
Downloads the Lich project template
Generates a complete project structure
Sets up Docker, backend, and frontend

Options¶

Option	Description
`--no-input`	Use all defaults, no prompts
`--help`	Show help

Interactive Prompts¶

When you run lich init, you'll be asked:

Project Name¶

? Project name: my_awesome_app

Used for folder name and package names.

Project Type¶

? Project type:
  > saas_platform
    trading_platform
    ai_application

Affects default configurations.

Auth Strategy¶

? Auth strategy:
  > jwt_builtin    (Simple JWT auth built-in)
    keycloak       (Enterprise SSO)
    none           (No auth)

Database¶

? Database:
  > postgresql
    mongodb

Use Redis?¶

? Use Redis? [Y/n]: Y

For caching and sessions.

Example¶

Full Interactive¶

$ lich init

🧙 Lich Toolkit - Project Generator

? Project name: my_saas
? Project type: saas_platform
? Auth strategy: jwt_builtin
? Database: postgresql
? Use Redis? Yes

📦 Creating project 'my_saas'...
✅ Project created!

Next steps:
  cd my_saas
  lich dev

Quick with Defaults¶

$ lich init --no-input

📦 Creating project with defaults...
✅ Project 'my_app' created!

Generated Structure¶

After lich init, you'll have:

my_saas/
├── .lich/                 # Lich config & AI rules
├── backend/               # FastAPI application
│   ├── api/http/          # API routers
│   ├── internal/          # Business logic
│   └── main.py
├── frontend/              # Next.js application
├── docker-compose.yml     # Docker services
├── .env.example           # Environment template
└── README.md

Best Use Cases¶

Scenario	Command
New project with customization	`lich init`
Quick prototype	`lich init --no-input`
Team project with Keycloak	`lich init` → select keycloak

Common Issues¶

Template Download Failed¶

If template download fails:

Check internet connection
Verify GitHub access
Try again: lich init

Already in a Lich Project¶

If you get "Already in a Lich project" error:

cd ..
lich init