Asklepios

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

(★ 57)

No description available.

Asklepios Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# QwenMedicalAgent — 医疗 VLM + Agent 系统

一个端到端的医疗多模态智能体系统：以 **MediX-R1-8B**（Qwen3-VL backbone，视觉+语言）为推理底座，叠加**多 Agent 协作**、**RAG 指南证据增强**、**短期/长期记忆**、**医学影像问答**与 **Web 可视化**。

> 研究/演示用途，**不能替代专业医生诊断**。

## 架构总览

```
                          ┌─────────────────────────────────────────┐
   浏览器 ── SSH隧道 ──►   │ Web (FastAPI + SSE)  Asklepios/agent/web │
                          └───────────────┬─────────────────────────┘
                                          │  文本 → Swarm 路由        图像 → 单轮 VLM
                          ┌───────────────▼─────────────────────────┐
                          │ LangGraph 编排：LeadAgent 分解 → 并行扇出  │
                          │ consultation/diagnostic/research worker   │
                          │（9 skills；ReAct 循环同为 StateGraph 图）  │
                          │ + 安全层(约束校验/自动修复) + 接地/身份锁定 │
                          └──────┬───────────────┬──────────────┬────┘
                          RAG    │       记忆     │     推理      │
                  ┌──────────────▼──┐  ┌──────────▼───┐  ┌───────▼────────┐
                  │ Milvus + BGE-M3 │  │ 短期(Redis)   │  │ vLLM :8000      │
                  │ (medical-milvus)│  │ 长期(Milvus)  │  │ MediX-R1-8B 256K│
                  └─────────────────┘  └──────────────┘  └────────────────┘
```

## 仓库结构

| 路径 | 组件 | 说明 |
|---|---|---|
| **`Asklepios/`**| **Agent 产品（自包含、可整体迁移）**| `agent/`（可安装包 `asklepios`：core/agents/swarm/knowledge/memory/research/guardrails + 9 skills；外层 `web/` + `tests/`）、`serving/`（起 vLLM 底座）、`infra/`（起 Milvus/Redis/Phoenix/Web，`demo.sh` 一键编排 + 健康探针 + OTel 追踪）、`diag/`（工程诊断脚本：压测/评测/检索调优）、`models/`（MediX-R1-8B + BGE×2）、`data/`（milvus_data/rag_corpus/med_image/benchmark）。详见 [agent README](Asklepios/agent/README.md) |
| **`config.py`**| LLM 接入契约 | 推理端点配置；密钥从 `~/.config/` 读，不入库 |
| **`docker/`**| 容器 | Dockerfile（运行环境 `medix-fix`） |

> Agent 与推理底座只经 vLLM `:8000`（OpenAI 兼容 HTTP）耦合，换底座重起 vLLM 即可、Agent 侧零改动；资产路径由 `Asklepios/agent/asklepios/paths.py` 统一锚定，可在任意部署路径运行。

## 快速上手

运行环境在容器 `medix-fix`（挂载本目录 → `/workspace`）。

```bash
# 一键启停整套演示环境（向量库 + 缓存 + vLLM + Web + 公网隧道）
bash Asklepios/infra/demo.sh up       # 拉起，含 GPU 预检与就绪等待
bash Asklepios/infra/demo.sh status   # 五件套自检 + 物理 GPU 占用
bash Asklepios/infra/demo.sh down     # 反序关停并释放 GPU，让给别的实验
#   浏览器经 SSH 隧道访问：ssh -L 8080:127.0.0.1:8080 <server> → http://localhost:8080
#   调用链追踪（Phoenix UI）：ssh -L 6006:127.0.0.1:6006 <server> → http://localhost:6006
#   单独启停某一件见 Asklepios/infra/README.md

# 测试（先在 Asklepios/agent 下 pip install -e . 装包；集成/冒烟需上述服务已起）
docker exec medix-fix bash -c "cd /workspace/Asklepios/agent && python -m pytest -ra"

# 工程诊断（容量/上下文边界/对抗/视觉评测）
docker exec medix-fix python3 /workspace/Asklepios/diag/stress/ctx_probe.py
```

## 能力边界（当前）

- 文本问诊（单 Agent / 多 Agent Swarm 协作，LangGraph 编排）、RAG 指南证据、ICD/风险/症状等 9 skills
- 医学影像问答（VLM 视觉链路，Web 支持上传/拖拽/粘贴）
- 短期（会话）+ 长期（跨会话 Milvus 语义）记忆
- 提示注入 / 越界防御、接地防幻觉、安全层（免责/高危就医提示）
- 上下文窗口 256K（needle-in-haystack 250K 召回验证）
- 底座可替换：Agent 仅经 vLLM OpenAI 兼容 HTTP 与模型耦合，换底座重起 vLLM 即可，Agent 侧零改动

Asklepios

Asklepios Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Asklepios

Asklepios Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README