mellea

环境要求

• 可用的 Python 环境（README 未标注具体版本要求）
• 已安装 uv 包管理工具（README 用 uv pip 安装）
• 能获取一个大语言模型会话（start_session() 的具体配置见官方安装文档）

安装与启动步骤

1. 1安装 Mellea

   用 uv 从 PyPI 安装 Mellea 核心库，README 给出的唯一安装命令就是这一条。

   uv pip install mellea

   复制

2. 2按需装全部扩展

   需要额外可选组件时安装 all extras；普通使用可跳过这一步。

   uv pip install 'mellea[all]'

   复制

3. 3从源码安装

   想直接用本仓库源码安装，请按仓库根目录 CONTRIBUTING.md 的说明操作。

4. 4写一个生成式程序

   把示例保存为 run.py：docstring 变成提示词，类型注解变成输出 schema。

   from pydantic import BaseModel
   from mellea import generative, start_session
   
   class UserProfile(BaseModel):
       name: str
       age: int
   
   @generative
   def extract_user(text: str) -> UserProfile:
       """Extract the user's name and age from the text."""
   
   m = start_session()
   user = extract_user(m, text="User log 42: Alice is 31 years old.")
   print(user.name)
   print(user.age)

   复制

5. 5运行脚本

   执行脚本，观察返回对象是否按 UserProfile 结构解析出字段。

   python run.py

   复制

如何确认成功

运行 run.py 后正常输出 Alice 与 31，说明会话已启动，结构化调用成功。

常见问题

注意事项

• README 仅给出 uv pip install 安装方式，未列出 pip/conda 等替代命令。
• README 未标注支持的 Python 版本、端口或本地服务配置，这类信息需查官方文档。
• 更多安装选项见 https://docs.mellea.ai/getting-started/installation。