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
```
文件与辅助工具。
Evals：评估器与数据集。
开发工作流：
```
genkit start
```
、开发UI、检查清单。