実際に制作に取り組むAIエージェントの構築に向けた生産準備体制

すぐにスタート

まず、[copier]をインストールする必要があります。 uv:])で行うことをお勧めします

[!TIP] このツールをインストールしたくない場合は、[uvx] コマンドを[copier copy]前で使うこともできます。

このテンプレートを使用するには、次のコマンドを実行します。

[[T5]の代わりに、プロジェクトを生成したいディレクトリ名を置きます。 間接パスを使うことができます。

【重要】

• [copier copy DOESN’T は新しいディレクトリを作成し、ファイルを $TARGET DIRECTORY にコピーします。
• 最新のリリースからバージョンをコピーします
• 最新の未公開コミットから取得したい場合は、フラグ[[-r HEADを使用します(また、リモートブランチ名を受け入れる)

既にプロジェクトやテンプレートが更新されてしまった場合は、プロジェクトを更新できます。

【重要】

• このコマンドを使用するためにプロジェクトHASがgitリポジトリになるようにする
• omit [--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