Metadata-Version: 2.4
Name: mi-maica
Version: 1.3.3.post3
Summary: MAICA Illuminator (Backend)
Author-email: EdgeInfinity <dcc@monika.love>
License-Expression: MIT
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: aiohttp<4,>=3.14.1
Requires-Dist: aiomysql>=0.2.0
Requires-Dist: aiosqlite>=0.21.0
Requires-Dist: APScheduler>=3.11.0
Requires-Dist: asyncssh>=2.21.0
Requires-Dist: bcrypt>=3.2.2
Requires-Dist: colorama>=0.4.6
Requires-Dist: flashtext>=2.7
Requires-Dist: httpx>=0.27.0
Requires-Dist: Hypercorn==0.17.3
Requires-Dist: lunar_python>=1.4.4
Requires-Dist: mcp>=1.16.0
Requires-Dist: openai>=2.24.0
Requires-Dist: orjson>=3.11
Requires-Dist: pillow>=12.0
Requires-Dist: cryptography>=44
Requires-Dist: pydantic[email]>=2.11
Requires-Dist: pymilvus[milvus_lite]>=3.0.0
Requires-Dist: python-dotenv>=1.0.1
Requires-Dist: python-dateutil>=2.9
Requires-Dist: pytz>=2024.2
Requires-Dist: Quart==0.20.0
Requires-Dist: packaging>=24
Requires-Dist: SQLAlchemy[asyncio]>=2.0
Requires-Dist: tenacity>=9.0.0
Requires-Dist: typing-extensions>=4.12
Requires-Dist: Werkzeug>=3.0
Requires-Dist: websockets>=12.0
Requires-Dist: wikipedia-api>=0.15.0
Requires-Dist: zhconv==1.4.3
Provides-Extra: dev
Requires-Dist: pytest>=9.0; extra == "dev"
Requires-Dist: ruff>=0.15; extra == "dev"
Provides-Extra: all
Requires-Dist: mi-mtts>=1.0.2; extra == "all"
Provides-Extra: mtts
Requires-Dist: mi-mtts>=1.0.2; extra == "mtts"
Dynamic: license-file

<h1 align="center">MAICA-幻象引擎</h1>
<div align="center">
<img src="https://maica.monika.love/assets/maica-text-finish-p.png" width=150>
</div>

<p align="center">中文 | <a href="/README_EN.md">English</a></p>

***

本页面是MAICA的指引页面, 当前位置是MAICA后端仓库.

MAICA项目的详细介绍页是https://maica.monika.love/.

要快速开始或了解授权, 请参阅https://maica.monika.love/tos.

***

MAICA的子模组前端仓库地址是https://github.com/Mon1-innovation/MAICA_ChatSubmod.

MAICA-MTTS的子模组前端仓库地址是https://github.com/Mon1-innovation/MAICA_MttsSubmod.

***

MAICA的后端仓库地址是https://github.com/Mon1-innovation/MAICA.

MAICA的后端compact分支地址是https://github.com/Mon1-innovation/MAICA_Server_Submod.

MAICA-MTTS的仓库地址是https://github.com/Mon1-innovation/MAICA_MTTS.

***

MAICA LOA分支的模型:
- MAICAv0-LOA6-7B-Instruct: https://huggingface.co/edgeinfinity/MAICAv0-LOA-7B

MAICA LIA分支的模型:
- MAICAv0-LIA6-72B-Instruct: https://huggingface.co/edgeinfinity/MAICAv0-LIA-72B

MAICA DAA分支的模型:
- MAICAv1-DAA4L-14B-Instruct: https://huggingface.co/edgeinfinity/MAICAv1-DAA4L-14B-Instruct
- MAICAv1-DAA4L-14B-Instruct-GGUF: https://huggingface.co/edgeinfinity/MAICAv1-DAA4L-14B-Instruct-GGUF
- MAICAv0-DAA1-72B-Instruct: 非公开
- MAICAv0-DAA2-72B-Instruct: 非公开
- MAICAv1-DAA3-235B-A22B-Instruct: 非公开
- MAICAv1-DAA4-397B-A17B-Instruct: 非公开

MAICA-MTTS模型:
- MTTSv0-VoiceClone: https://huggingface.co/edgeinfinity/MTTSv0-VoiceClone
- MTTSv1-VoiceClone: https://huggingface.co/edgeinfinity/MTTSv1-VoiceClone

MAICA的基本数据集仓库: 
- https://huggingface.co/datasets/edgeinfinity/MAICA_ds_basis

***

MAICA的相关文档存储于https://github.com/Mon1-innovation/MAICA/tree/main/document.

***

> Anything below this point is written by AI.

## 快速开始

MAICA 后端需要 Python 3.12 或更高版本，并支持 Windows 与 Linux。核心模型与 MFocus 模型使用 OpenAI-compatible Responses API，需要另行部署；数据库可使用 MySQL/MariaDB，单机测试也可使用 SQLite。

```bash
python -m pip install -e .
maica -t create
# 编辑 .env：至少设置 MAICA_IS_REAL_ENV、数据库以及 MCORE/MFOCUS 连接
maica -e .env
```

默认监听 WebSocket `:5000` 与 HTTP `:6000`，可通过 `MAICA_WS_HOST/PORT` 和 `MAICA_HTTP_HOST/PORT` 修改。完整配置项及说明见 [`maica/env_basis`](maica/env_basis)；部署步骤见 [`document/Backend Deployment.md`](document/Backend%20Deployment.md)，接口协议见 [`document/API Documents.md`](document/API%20Documents.md)。

## 开发与验证

```bash
python -m pip install -e ".[dev]"
python -m pytest -q
python -m ruff check maica tests examples
```

`examples/` 中的脚本是需要真实模型或 Milvus 的手工连通性检查，不属于离线测试。维护者应同时阅读 [`document/MAINTENANCE.md`](document/MAINTENANCE.md)。

## 部署安全

公开实例应在反向代理上启用 TLS；HTTP 鉴权优先使用 `Authorization: Bearer <access_token>`，避免把令牌写入 URL。请保管 `maica/keys/prv.key`，为 NVWatcher 配置 SSH host key，并通过 `MAICA_MVISTA_TRUSTED` 的主机/IP/CIDR 规则限制视觉模型的图片来源。
