MCPcopy Index your code
hub / github.com/Xeron2000/openOii

github.com/Xeron2000/openOii @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
3,373 symbols 14,357 edges 344 files 445 documented · 13%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

openOii

openOii logo

故事想法 → 多智能体协作 → 漫剧成片

一个以 LangGraph 为核心的 AI 漫剧生成学习项目。

<img src="https://img.shields.io/badge/Python-3.10+-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python 3.10+" />
<img src="https://img.shields.io/badge/FastAPI-0.115+-009688?style=flat-square&logo=fastapi&logoColor=white" alt="FastAPI" />
<img src="https://img.shields.io/badge/React-18-61DAFB?style=flat-square&logo=react&logoColor=111827" alt="React 18" />
<img src="https://img.shields.io/badge/LangGraph-Orchestration-6D28D9?style=flat-square" alt="LangGraph" />







<a href="#快速开始">快速开始</a> ·
<a href="#界面预览">界面预览</a> ·
<a href="#技术栈">技术栈</a>

openOii 把故事创意串成 规划、角色/分镜生成、视频生成与合成 的完整链路,并用无限画布展示过程与结果。

[!WARNING] 这是一个 LangGraph 学习 / 演示项目,重点是验证多阶段编排、恢复执行、实时进度与前后端协作。 不适合直接用于工业生产环境

你能看到什么

  • 多阶段 AI 生成链路
  • WebSocket 实时进度
  • 可恢复 / 可取消 / 可反馈的 run 流程
  • tldraw 无限画布审阅角色、分镜与结果
  • 前端环境变量配置面板

界面预览

openOii 首页 首页 · 故事输入与风格选择 openOii 画布与生成流程 画布 · 角色、分镜与生成流程
openOii 配置面板 配置面板 · 在线管理模型与基础服务

技术栈

  • Frontend: React 18 + TypeScript + tldraw
  • Backend: FastAPI + SQLModel + LangGraph
  • Infra: PostgreSQL + Redis + /static

快速开始

cp backend/.env.example backend/.env
docker-compose up -d
  • Frontend: http://localhost:15173
  • API Docs: http://localhost:18765/docs

本地开发:

# backend
cd backend
uv sync
uv run uvicorn app.main:app --reload --host 0.0.0.0 --port 18765

# frontend
cd frontend
pnpm install
pnpm dev

常用命令

# backend
cd backend
uv run pytest
uv run ruff check app tests

# frontend
cd frontend
pnpm test
pnpm build

License

MIT

Extension points exported contracts — how you extend this code

ImportMetaEnv (Interface)
(no doc)
frontend/app/vite-env.d.ts
Window (Interface)
(no doc)
frontend/tests/e2e/workflow-stage-sync.spec.ts
ImportMeta (Interface)
(no doc)
frontend/app/vite-env.d.ts
ProjectProviderEntry (Interface)
(no doc)
frontend/app/types/index.ts
ProjectProviderSettings (Interface)
(no doc)
frontend/app/types/index.ts
ProjectProviderOverridesPayload (Interface)
(no doc)
frontend/app/types/index.ts

Core symbols most depended-on inside this repo

create_project
called by 216
backend/tests/factories.py
create_run
called by 114
backend/tests/factories.py
execute
called by 107
backend/aiosqlite/__init__.py
make_context
called by 86
backend/tests/agent_fixtures.py
commit
called by 83
backend/aiosqlite/__init__.py
send_event
called by 78
backend/app/ws/manager.py
create_shot
called by 74
backend/tests/factories.py
send_message
called by 60
backend/app/agents/base.py

Shape

Function 1,801
Method 940
Class 406
Interface 149
Route 77

Languages

Python85%
TypeScript15%

Modules by API surface

backend/tests/test_services/test_text_service.py217 symbols
backend/tests/test_agents/test_orchestrator.py105 symbols
backend/tests/test_services/test_video.py95 symbols
backend/tests/test_services/test_image_service.py87 symbols
backend/tests/test_services/test_llm_service.py71 symbols
frontend/app/types/index.ts66 symbols
backend/tests/test_schemas/test_ws_events.py61 symbols
backend/tests/test_api/test_config.py58 symbols
backend/tests/test_agents/test_orchestrator_helpers.py57 symbols
backend/tests/test_orchestration/test_nodes.py53 symbols
backend/tests/test_agents/test_compose.py51 symbols
backend/tests/test_services/test_doubao_video.py49 symbols

Datastores touched

dbDatabase · 1 repos
testdbDatabase · 1 repos

For agents

$ claude mcp add openOii \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact