kraft-cli 0.2.1

Python service scaffolding with zero learning curve

kraft

Python service scaffolding with zero learning curve.

Installation

Using uvx (recommended - no installation needed)

uvx kraft

Using uv tool (persistent installation)

uv tool install kraft-cli
kraft create my-api

Using pipx (if you have it)

pipx install kraft-cli
kraft create my-api

Using pip (traditional installation)

If you get "externally managed environment" error, try:

# Option 1: Install to user directory
pip3 install --user kraft-cli
kraft create my-api

# Option 2: Use pipx (install it first if needed)
pip3 install --user pipx
pipx install kraft-cli
kraft create my-api

# Option 3: Use a virtual environment
python3 -m venv ~/kraft-env
source ~/kraft-env/bin/activate
pip3 install kraft-cli
kraft create my-api

Note: If you get "externally managed environment" error with pip, use uvx or uv tool install instead.

Usage

Create a REST service

# Using uvx (no install needed)
uvx kraft-cli create my-api

# Or if you installed with uv tool/pipx
kraft create my-api

Then run it:

cd my-api
docker-compose up --build

Your API is now running at http://localhost:8000/books

Add PostgreSQL database

kraft add postgres
# or: uvx kraft-cli add postgres

Create with add-ons in one command

kraft create my-api --with postgres

List available templates and add-ons

kraft list      # Show templates
kraft addons    # Show add-ons

Shell Completion (Optional)

kraft --install-completion zsh

Restart your shell to enable Tab completion for commands and options.

Development

Setup

Using uv (recommended):

uv sync --extra dev

Using pip:

pip install -e ".[dev]"

Running Tests

# With uv
uv run pytest

# With pip (after activating venv)
pytest

Linting

# With uv
uv run ruff check src/

# With pip (after activating venv)
ruff check src/

Type Checking

# With uv
uv run mypy src/

# With pip (after activating venv)
mypy src/

License

MIT