create-gentiq-app 🚀

The official CLI for bootstrapping Gentiq applications. Kickstart your agentic chatbot in seconds.

Quick Start

The fastest way to get started with Gentiq is to run the following command in your terminal:

npx create-gentiq-app@latest my-awesome-ai

Or with Yarn:

yarn create gentiq-app my-awesome-ai

Or with PNPM:

pnpm create gentiq-app my-awesome-ai

What is Gentiq?

Gentiq is a world-class AI agent framework designed for building production-ready, conversational applications. It combines the power of PydanticAI on the backend with a high-performance React frontend, providing everything you need out-of-the-box.

Features Scaffolded:

• ⚡ AI Streaming: Real-time agent responses via PydanticAI and Vercel AI SDK.
• 🛠️ Admin Dashboard: Built-in analytics, history logs, and user management.
• 💰 Atomic Balance: Native tracking and enforcement of per-user token and request limits.
• 📂 Flexible Persistence: Integrated MinIO/S3 for file storage and MongoDB for state.
• 🔒 Enterprise-Grade Security: Full JWT authentication suite and encrypted sessions.

Project Structure

When you initialize a new app, the CLI generates a modern, monorepo-friendly structure:

my-awesome-ai/
├── backend/            # FastAPI + PydanticAI application
│   ├── main.py         # App entry point
│   └── pyproject.toml  # Python dependencies (UV managed)
├── frontend/           # Vite + React application
│   ├── src/            # UI components and hooks
│   └── package.json    # Frontend dependencies
├── .env.example        # Environment variable template
└── README.md           # Your project documentation

Local Development

Once your project is scaffolded, follow these steps to get running:

1. Environment Setup

Copy the example environment file and add your API keys and modify other variables as desired:

cp .env.example .env

2. Launch Backend

The backend uses uv for lightning-fast Python package management.

cd backend
uv sync
uv run uvicorn main:app.api --reload --port 8000

3. Launch Frontend

cd frontend
npm install
npm run dev

Your app is now live at http://localhost:5173!

Why Gentiq?

Unlike generic boilerplates, Gentiq is built with developer velocity and production scalability in mind. It provides the "boring" parts of AI development—authentication, rate limiting, and persistence—so you can focus on building your agents.

• Type-Safe: End-to-end TypeScript and Python (Pydantic) types.
• Customizable: Every part of the UI and Backend is modular and extensible.
• Modern Stack: React 19, FastAPI, PydanticAI, and TailwindCSS.