Готовая к производству структура для создания агентов ИИ, которые фактически работают в производстве.

Быстрый старт

Во-первых, вам нужно установить copier. Мы предлагаем сделать это [[Т1]] [[Т2]].

[!TIP] Вы также можете использовать uvx перед copier copy командой, если вы не хотите устанавливать этот инструмент.

Чтобы использовать этот шаблон, запустите:

Вместо $TARGET_DIRECTORY введите имя каталога, где вы хотите создать свой проект. Можно использовать косвенный путь. [!Важно] copier copy Не создает новый каталог, он просто копирует файлы в $TARGET DIRECTORY

• он будет копировать версию последнего выпуска Если вы хотите извлечь из последних неизданных обязательств, используйте флаг -r HEAD (также принимает имена удаленных ветвей).

Если вы уже создали проект и шаблоны обновляются, вы все равно можете обновить свой проект:

[!Важно] Ваш проект должен быть git repo, чтобы использовать эту команду.

• опустить флаг --defaults, если вы хотите обновить ответы python_versions Вы также можете использовать флаг -r здесь для обновления с помощью версии шаблона из неизданных версий.

- Дополнительные дополнения

Python AI Kit

A production-ready framework for building AI agents that actually work in production.

🚀 Quick Start

First, you need to have copier installed. We suggest to do it with uv (https://docs.astral.sh/uv/getting-started/installation/#installation-methods):

uv tool install copier

[!TIP] You can also just use uvx before copier copy command if you don’t want to install this tool.

To use this template, run:

copier copy https://github.com/the-momentum/python-ai-kit $TARGET_DIRECTORY --trust
# uvx copier copy https://github.com/the-momentum/python-ai-kit $TARGET_DIRECTORY --trust

Instead of $TARGET_DIRECTORY put directory name where you want to generate your project. You can use indirect path.

[!IMPORTANT]

• copier copy DOESN’T create new directory, it just copies files to $TARGET_DIRECTORY
• it will copy version from latest release
• if you want to fetch from latest unreleased commit, use flag -r HEAD (also accepts remote branches names)

If you’ve already created project and templates get updated, you can still update your project:

copier update --trust --defaults
# run this inside ypur project directory

[!IMPORTANT]

• your project HAS to be a git repo in order to use this command
• omit --defaults flag, if you want to update answers (like python_versions)
• you can also use flag -r here to update with template version from unreleased versions

🔧 Optional add-ons

Some setup options require extra tools to be installed beforehand. If you skip them, the template will fail when that option is selected.

DVC (Data Version Control)

• Requires: dvc installed (e.g. uv tool install dvc) and, when enabled, AWS CLI with a profile that has access to your DVC S3 bucket.
• During setup: You can enable DVC when prompted; you will then provide the full S3 path (starting with s3://) for the remote and the AWS region.
• After generation: Set your AWS profile locally in the project root (stays out of Git):
  dvc remote modify --local profile (use the remote name you chose during setup)

Features

Core Framework

• Multi-agent orchestration - Built-in support for coordinating multiple specialized agents with defined workflows and error handling
• State management - Persistent memory across sessions using dedicated database storage and thread preservation
• Observability by default - Integrated logging, tracing, and monitoring with Pydantic Logfire or Opik
• Structured prompt management - Modular, versioned prompts with POML patterns instead of monolithic strings

Development & Testing