convez.ai
MCP ServerAutomaçãoAvançado
lzf00

TrailLens - Assistente Multi-Agente para Fotógrafos de Paisagem

lzf00/traillens

Seleção e análise inteligente de fotos de trilhas com múltiplos agentes e modelo estético personalizado

Ver no GitHub
InicialPluginScore · de 0 a 100

Sistema MCP que automatiza a curadoria de fotografias de trilhas através de múltiplos agentes especializados. Executa seleção de fotos, crítica visual, geração de narrativas de viagem e planejamento de futuras expedições usando um modelo de escore estético customizado para fotografia de paisagem.

Instalação

$npx convez-ai lzf00/traillens

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
57%
Último commit
há 4 meses
Versão
—
Issues abertas
10
Contribuidores
2

Casos de uso

  • Curadoria automática de centenas de fotos após expedição de hiking
  • Geração de críticas técnicas e narrativas de viagem com dados EXIF e clima
  • Planejamento de próximas expedições com horários de pôr/nascer do sol e previsão

Veredito

Projeto ambicioso de agentic AI com diferencial técnico real: modelo estético próprio (Q-Align + LoRA) treinado especificamente para paisagens. Arquitetura bem pensada com LangGraph, fallback sem dependências e integração via MCP servers. Ideal para quem quer entender orquestração multi-agente em produção.

README

A tradução para o português deste README ainda está na fila.

TrailLens 🏔️📸

把整组徒步照片丢进去 → AI 自动选片、点评、生成游记,并规划你下次的拍摄计划。 一个面向风光摄影师的多智能体(multi-agent)助手,核心是一个自研的风光摄影美学评分模型。


这是什么

TrailLens 接收一次徒步产出的整组照片(RAW/JPG)+ 可选的 GPX 轨迹,由一个 supervisor 编排的多智能体系统完成五件事:

子 Agent职责关键技术
Culling过滤模糊/重复/废片,对候选片做 8 维美学评分OpenCV + pHash + 自研美学模型
Critic对精选片生成构图/光影/技术的自然语言点评Qwen3-VL / Claude,AesExpert 风格
Story结合 EXIF 时序与天气生成图文游记多模态 + 天气 MCP
Planner为"下次再来"生成蓝/金时间、机位、装备清单天文/天气 MCP
HumanReview不确定的片交人工裁决,反馈回流个性化记忆(PIAA)LangGraph interrupt + Mem0

与一般"套壳 GPT"的项目不同,TrailLens 的差异化在于自研算法贡献:一个针对 风光摄影领域微调的美学评分模型(基于 Q-Align + LoRA),解决主流美学数据集 (AVA/PARA)偏人像、对风光照系统性误判的问题。详见 docs/RESEARCH.md。

⚡ 快速开始

零依赖跑通骨架(无需 GPU、无需 API key、无需装包):

git clone https://github.com/<you>/traillens.git
cd traillens/packages/agents
python3 -m traillens_agents.demo

你会看到完整的多智能体路由轨迹:选片 → 人工裁决 → 点评 → 游记 → 计划。

设计上做了无依赖 fallback:装了 langgraph 走真实编译图;没装则走纯 Python supervisor 循环。这保证作品集"一键复现"永不翻车。

完整运行(真实模型 + 全栈):

pip install -r requirements.txt          # langgraph, pydantic, fastapi, torch ...
cp .env.example .env                      # 填入 ANTHROPIC_API_KEY 等
docker compose up                         # 起 Postgres(pgvector) + API + web

🏗️ 架构

flowchart TD
    U[用户上传<br/>照片 + GPX] --> ORC{Orchestrator<br/>supervisor 路由}
    ORC -->|next_agent=culling| CUL[Culling Agent]
    ORC -->|next_agent=human_review| HR[HumanReview<br/>HITL]
    ORC -->|next_agent=critic| CRI[Critic Agent]
    ORC -->|next_agent=story| STO[Story Agent]
    ORC -->|next_agent=planner| PLA[Planner Agent]
    ORC -->|FINISH| OUT[精选片 + 游记 + 拍摄计划]

    CUL --> ORC
    HR --> ORC
    CRI --> ORC
    STO --> ORC
    PLA --> ORC

    CUL -.调用.-> AES[(美学评分模型<br/>Q-Align+LoRA<br/>Modal endpoint)]
    CUL -.调用.-> MCP1[EXIF MCP]
    STO -.调用.-> MCP2[Weather MCP]
    PLA -.调用.-> MCP3[Sun/Moon MCP]
    CRI -.调用.-> VLM[Qwen3-VL / Claude]

    style ORC fill:#2d4a3e,color:#fff
    style AES fill:#7a3b2e,color:#fff

关键设计决策(tradeoff,面试常被追问):

  • 为什么用 LangGraph 而非 CrewAI? 本任务有 HITL 中断、条件分支(无 GPS 则跳过 Planner)、可观测性需求,需要显式状态机而非线性流。CrewAI 适合快速原型,不适合 这种带状态回路的编排。
  • 为什么自托管 Qwen3-VL 而非纯调 GPT-4o? 批量选片调用量大,自托管开源 VLM 的 单位成本远低;点评等低频高质量环节再用 Claude。成本/质量分层。
  • 为什么所有外部能力都封装为 MCP server? 让 EXIF/天气/天文能力可被 Claude Desktop、Cursor、ChatGPT 直接复用,也让 agent 与工具解耦、可独立测试与开源。

📁 项目结构

traillens/
├── packages/
│   ├── agents/traillens_agents/      # ★ 多智能体核心(本仓库可独立运行)
│   │   ├── state/schema.py           #   共享 State + AestheticScore 契约
│   │   ├── tools/clients.py          #   工具层(美学模型 / MCP 客户端)
│   │   ├── nodes/business.py         #   5 个业务节点
│   │   ├── orchestrator.py           #   supervisor + LangGraph 图组装
│   │   └── demo.py                   #   零依赖端到端 demo
│   ├── aesthetic/                    # ★ 自研美学评分模型(独立开源)
│   │   └── train_qalign_lora.py      #   LoRA 微调 + 评估 + 推理接口
│   └── mcp_servers/                  # EXIF / Weather / Sun-Moon MCP servers
├── apps/
│   ├── api/                          # FastAPI 后端
│   └── web/                          # Next.js + shadcn/ui 前端
├── docs/
│   ├── ARCHITECTURE.md
│   ├── EVAL.md                       # 可复现指标表
│   └── RESEARCH.md                   # 美学模型研究笔记 + 偏见声明
└── .github/workflows/                # CI + eval-on-PR

📊 评估

美学模型在 landscape 测试集上对每个维度报告 PLCC / SRCC(IAA 领域标准指标)。 评估脚本零依赖可跑:

cd packages/aesthetic && python3 train_qalign_lora.py demo-metric
维度zero-shot Q-Align本模型 (LoRA)提升
overallTODOTODOTODO
compositionTODOTODOTODO
technicalTODOTODOTODO

Go/No-Go 触发器(路线图 M2):overall 维度 PLCC > 0.78 才继续主线,否则降级为 "Q-Align 调用 + 摄影规则系统"的 hybrid 方案。指标填充流程见 docs/EVAL.md。

🗺️ 路线图

  • M1 多智能体骨架(本仓库)+ EXIF MCP server + 数据标注 SOP
  • M2 美学模型 LoRA 微调(PLCC>0.78)+ HuggingFace 权重 + 技术博客
  • M3 LangGraph 全链路 + 4 个 MCP servers + pgvector RAG + HITL
  • M4 Next.js 全栈 + Lightroom 导出插件 + Stripe
  • M5 公开 beta + Product Hunt / Show HN
  • M6 变现验证 + 求职 portfolio

⚠️ 限制与声明

  • 美学评分是辅助而非客观真理。模型带有训练数据的风格偏好("算法凝视"问题), 定位为个人风格助理而非评判标准。训练数据来源与标注流程公开在 docs/RESEARCH.md。
  • 路线/天气建议不可替代专业判断。Planner 输出不脱离已验证 trail 数据,且含 显式免责声明。AI 幻觉导致的户外事故有真实先例。
  • 用户照片可能含 GPS 隐私信息,默认本地处理、用户主动上传。

License

MIT(代码) / 美学模型权重见各自 model card。

Ver o original no GitHub

Bom para

Relacionados