Metadata-Version: 2.4
Name: lumanova
Version: 0.0.1.post2
Summary: LLM chat and TTS SDK (with built-in MeloTTS)
Author: AuroraChloe
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: requests
Dynamic: author
Dynamic: description
Dynamic: description-content-type
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

lumanova SDK
lumanova 是一个集成大模型智能对话与中文文本转语音（TTS，内置 MeloTTS 算法）的 Python SDK，支持一行开箱调用，便于二次开发和各种场景集成。
安装
确保目录结构如下：
Copy
lumanova/
├── lumanova/          # 主 SDK 代码
├── melotts/           # MeloTTS 代码
├── setup.py
└── README.md
在根目录下运行：
Copy
pip install .
# 或开发模式
pip install -e .
快速上手
1. 智能对话
python
Copy
from lumanova import Lumanova

client = Lumanova(api_key='your-api-key')

response = client.chat(
    model="qwen3-max-2026-01-23",
    messages=[
        {"role": "system", "content": "Talk like a pirate."},
        {"role": "user", "content": "How do I check if a Python object is an instance of a class? 用中文回答"},
    ],
)
print(response)
api_key：需要在 平台 获取
model：可选模型名称，默认 qwen3.5-plus
messages：对话内容（OpenAI 格式）、支持多角色多轮
2. 文本转语音（TTS）
python
Copy
from lumanova import LumaTTS

tts = LumaTTS(device='cpu')
audio_file = tts.tts("你好，世界！", output_path='hello.wav')
print(f"音频已保存至: {audio_file}")
device 默认为 "cpu"，Mac M1/M2 可尝试 "mps"
output_path 输出音频路径，可自定义文件名
典型结构
Lumanova：对话 API，直连模型服务
LumaTTS：文本转语音接口，构造实例后可多次快速生成音频
常见问题
权重加载慢？
TTS 模型首次加载需联网下载权重，之后本地缓存，合成速度极快。
只需随 SDK 一起 pip 安装，无额外依赖。
如遇到 API Key 配置异常或网络问题，可参考错误提示排查。
License
MIT
