Metadata-Version: 2.4
Name: lumanova
Version: 0.0.2.post3
Summary: LLM chat and TTS SDK (with built-in MeloTTS)
Author: AuroraChloe
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: txtsplit
Requires-Dist: torch
Requires-Dist: torchaudio
Requires-Dist: cached_path
Requires-Dist: transformers==4.27.4
Requires-Dist: num2words==0.5.12
Requires-Dist: unidic_lite==1.0.8
Requires-Dist: unidic==1.1.0
Requires-Dist: mecab-python3==1.0.9
Requires-Dist: pykakasi==2.2.1
Requires-Dist: fugashi==1.3.0
Requires-Dist: g2p_en==2.1.0
Requires-Dist: anyascii==0.3.2
Requires-Dist: jamo==0.4.1
Requires-Dist: gruut[de,es,fr]==2.2.3
Requires-Dist: g2pkk>=0.1.1
Requires-Dist: librosa==0.9.1
Requires-Dist: pydub==0.25.1
Requires-Dist: eng_to_ipa==0.0.2
Requires-Dist: inflect==7.0.0
Requires-Dist: unidecode==1.3.7
Requires-Dist: pypinyin==0.50.0
Requires-Dist: cn2an==0.5.22
Requires-Dist: jieba==0.42.1
Requires-Dist: gradio
Requires-Dist: langid==1.1.6
Requires-Dist: tqdm
Requires-Dist: tensorboard==2.16.2
Requires-Dist: loguru==0.7.2
Requires-Dist: comfykit
Requires-Dist: asyncio
Requires-Dist: httpx
Dynamic: author
Dynamic: description
Dynamic: description-content-type
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary


# lumanova SDK
lumanova 是一个集成大模型智能对话与中文文本转语音（TTS，内置 MeloTTS 算法）的 Python SDK，支持一行开箱调用，便于二次开发和各种场景集成。

## 安装
在根目录下运行：
pip install lumanova

## 快速上手
### 1.智能对话
```
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）
```
from lumanova import LumaTTS

tts = LumaTTS(device='cpu', api_key='your-api-key')
audio_file = tts.tts("你好，世界！", output_path='hello.wav')
print(f"音频已保存至: {audio_file}")
```
device 默认为 "cpu"，Mac M1/M2 可尝试 "mps"，N卡用户可使用cuda:0
output_path 输出音频路径，可自定义文件名

### 3.文生图/视频
```
from lumanova import LumaMM

media = LumaMM(api_key='your-api-key')
media_file = await mm.multimedia("生成一只狗的图片",)
print("生成结果:", media_file)
```
## 常见问题
权重加载慢？
TTS 模型首次加载需联网下载权重，之后本地缓存，合成速度极快。
只需随 SDK 一起 pip 安装，无额外依赖。
如遇到 API Key 配置异常或网络问题，可参考错误提示排查。
