developing-genkit-python

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Genkit Python

Prerequisites

前提条件

Runtime: Python 3.14+, uv
for deps (install).

CLI:

genkit --version

— install via

npm install -g genkit-cli

if missing.

New projects: Setup (bootstrap + env). Patterns and code samples: Examples.

运行环境：Python 3.14+，使用**
```
uv
```
**管理依赖（安装地址）。
命令行工具：执行
```
genkit --version
```
检查版本，若未安装可通过
```
npm install -g genkit-cli
```
安装。

新项目：初始化指南（项目初始化 + 环境配置）。模式与代码示例：示例集。

Hello World

python

from genkit import Genkit
from genkit.plugins.google_genai import GoogleAI

ai = Genkit(
    plugins=[GoogleAI()],
    model='googleai/gemini-flash-latest',
)

async def main():
    response = await ai.generate(prompt='Tell me a joke about Python.')
    print(response.text)

if __name__ == '__main__':
    ai.run_main(main())

python

from genkit import Genkit
from genkit.plugins.google_genai import GoogleAI

ai = Genkit(
    plugins=[GoogleAI()],
    model='googleai/gemini-flash-latest',
)

async def main():
    response = await ai.generate(prompt='Tell me a joke about Python.')
    print(response.text)

if __name__ == '__main__':
    ai.run_main(main())

Critical: Do Not Trust Internal Knowledge

重要提示：请勿依赖内部知识

The Python SDK changes often — verify imports and APIs against the references here or upstream docs. On any error, read Common Errors first.

Python SDK更新频繁——请务必参考此处的参考文档或上游文档验证导入语句和API。任何错误出现时，请先阅读常见错误。

Development Workflow

开发工作流

Default provider: Google AI (
```
GoogleAI()
```
), GEMINI_API_KEY
in the environment.
Model IDs: always prefixed, e.g. googleai/gemini-flash-latest
(always-on-latest Flash alias; same pattern as other skills).
Entrypoint: ai.run_main(main())
for Genkit-driven apps (not
```
asyncio.run()
```
for long-lived servers started with
```
genkit start
```
— see Common Errors).
After generating code, follow Dev Workflow for
```
genkit start
```
and the Dev UI.
On errors: step 1 is always Common Errors.

默认提供商：Google AI (
```
GoogleAI()
```
)，需在环境变量中配置**
```
GEMINI_API_KEY
```
**。
模型ID：始终带有前缀，例如**
```
googleai/gemini-flash-latest
```
**（始终指向最新版Flash的别名；格式与其他技能一致）。
入口点：Genkit驱动的应用需使用**
```
ai.run_main(main())
```
**（对于通过
```
genkit start
```
启动的长期运行服务器，请使用
```
asyncio.run()
```
而非此方法——详见常见错误）。
生成代码后，请遵循开发工作流使用
```
genkit start
```
和开发UI。
遇到错误时：第一步永远是查看常见错误。

References

参考文档

Examples: Structured output, streaming, flows, tools, embeddings.
Setup: New project bootstrap and plugins.
Common Errors: Read first when something breaks.
FastAPI: HTTP,
```
genkit_fastapi_handler
```
, parallel flows.
Dotprompt:
```
.prompt
```
files and helpers.
Evals: Evaluators and datasets.
Dev Workflow:
```
genkit start
```
, Dev UI, checklist.

示例集：结构化输出、流式传输、工作流、工具、嵌入。
初始化指南：新项目初始化与插件配置。
常见错误：出现问题时请首先阅读。
FastAPI：HTTP服务、
```
genkit_fastapi_handler
```
、并行工作流。
Dotprompt：
```
.prompt
```
文件与辅助工具。
评估工具：评估器与数据集。
开发工作流：
```
genkit start
```
、开发UI、检查清单。