aikit-cli

aikit-cli is a lightweight command-line tool for scaffolding minimal AI projects.
It provides opinionated, ready-to-use boilerplate for common AI patterns.

Installation

pip install aikit-cli

Usage

Create a new project:

# Interactive mode
aikit-cli new my-bot

# One-liner
aikit-cli new my-bot --type chatbot --provider openai

Options

Examples

Interactive Mode (Recommended):

aikit-cli new my-bot

Quick Create (Chatbot with OpenAI):

aikit-cli new my-bot --type chatbot --provider openai

Local RAG Project (with Ollama):

aikit-cli new local-rag --type rag --provider ollama

Generated Structure

After creating a project, you'll get a clean structure similar to this:

my-bot/
├── .env                # Environment variables (API keys, etc.)
├── app/
│   ├── __init__.py
│   ├── main.py         # Entry point
│   ├── config.py       # Configuration settings
│   └── provider.py     # LLM provider wrapper
├── pyproject.toml      # Project dependencies
└── README.md

Running Your Project

1. Navigate to the created directory:

   cd my-bot
   

TODO: Add poetry/uv support + dependencies

2. Install dependencies:

   pip install .  # or use poetry/uv
   

3. Configure environment:

   • For OpenAI: Add OPENAI_API_KEY=sk-... to .env.
   • For Ollama: Ensure Ollama is running (ollama serve).

4. Run the app:

   python app/main.py
   

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

License

MIT