gentiq 0.4.4

A world-class, modular framework for building production-ready AI chatbots.

Gentiq Backend Framework (Python)

Location: /packages/gentiq-python

The core Python backend engine for the Gentiq Framework. This package provides a modular FastAPI-based framework for building AI chatbots with Pydantic AI.

Features

• GentiqApp Factory: Rapidly initialize a production-ready chatbot backend with standard API routes, security, and persistence.
• Dependency Injection: Reusable FastAPI dependencies for application-scoped resources like Database and Storage via request.app.state.
• AI Agent Engine: Orchestrate complex PydanticAI streaming agents with built-in instrumentation and event-driven architectures.
• Atomic Balance Tracking: Integrated per-user token and request balance monitoring and management.
• Advanced Admin Management: Secure API endpoints for user analytics, chat history auditing, and permission-based administration.

Installation

As this is part of a monorepo, it is recommended to install it as an editable dependency for local development:

# In your app's pyproject.toml
[tool.uv.sources]
gentiq = { path = "../../../packages/gentiq-python", editable = true }

Quick Start (Minimal App)

from gentiq import GentiqApp
from pydantic_ai import Agent

agent = Agent(...)
app = GentiqApp(agent)

Key Modules

• gentiq.factory: The main application orchestrator.
• gentiq.api.dependencies: Standard FastAPI dependency providers (get_database, authenticate, etc.).
• gentiq.api.routes: Built-in modular route groups for auth, admin, chat, and users.
• gentiq.database: MongoDB models and atomic transaction operations.
• gentiq.storage: MinIO/S3 integrated file storage module.