collab-agent README

The project's README from github.com/Iwtbs27/collab-agent. As one markdown file: README.md.

OmniAct

一个 Agent,跨越每个数字环境。
One agent. Every digital environment.

English · 简体中文

OmniAct 是一个轻量级的跨环境通用行动 Agent,帮助用户在浏览器、桌面应用和 CLI 之间完成真实的数字工作。

MIT License Python 3.11 早期开发

为什么是 OmniAct

很多 Agent 在单一环境中表现出色:Coding Agent 在代码仓库中工作,Browser Agent 在网页中工作,Desktop Agent 在应用中工作。但真实的数字任务经常跨越这些环境。

OmniAct 围绕这个边界设计:

工作方式

用户目标
   |
   v
TeamLeader
   |
   +-- Browser Worker  -> 浏览器观测与产物
   +-- CLI Worker      -> Codex 会话与文件产物
   +-- Desktop Worker  -> Windows 应用操作与产物
   |
   v
任务结果、执行轨迹和最终交付物

TeamLeader 负责整体任务,只派发边界清晰的子任务。每个 Worker 负责自己的执行环境,并将交接内容写入任务目录。Worker 不需要共享内部状态,也不直接依赖其他 Worker。

任务目录让协作过程透明可检查:

tasks/<task-id>/
├─ task.md
├─ trace.jsonl
├─ trajectory.md
├─ workers/
│  └─ <worker-name>/
│     ├─ request.md
│     ├─ result.md
│     └─ artifacts/
└─ final/
   └─ result.md

快速开始

环境要求

安装

conda create -n omniact python=3.11
conda activate omniact
python -m pip install -r requirements.txt
Copy-Item .env.example .env

配置

在 .env 中填写模型服务配置:

TEAM_LEADER_API_KEY=
TEAM_LEADER_BASE_URL=
TEAM_LEADER_MODEL=

BROWSER_WORKER_API_KEY=
BROWSER_WORKER_BASE_URL=
BROWSER_WORKER_MODEL=
BROWSER_WORKER_SESSION_MODE=inherited

# 可选:Windows Desktop Worker
DESKTOP_WORKER_ENABLED=false
DESKTOP_WORKER_API_KEY=
DESKTOP_WORKER_BASE_URL=
DESKTOP_WORKER_MODEL=
DESKTOP_WORKER_MAX_STEPS=50

# 可选:Codex CLI Worker
CLI_WORKER_ENABLED=false
CODEX_EXECUTABLE=codex.cmd
CODEX_SANDBOX=workspace-write
CLI_WORKER_WORKING_DIRECTORY=
CLI_WORKER_MAX_TURNS=3

BROWSER_WORKER_SESSION_MODE 支持 inherited 和 clean。inherited 会将当前 Edge Profile 复制到隔离的 Worker 浏览器中,复用登录态但不会接管用户正在使用的浏览器窗口。

运行

在项目根目录执行:

python examples\run_team_leader.py

Worker 暂停等待人工接管时,示例程序支持:

takeover <worker-id>
resume <worker-id>
cancel <worker-id>

运行产物会写入 tasks/<task-id>/,其中包含任务说明、Worker 请求与结果、截图、文件产物和可读的执行轨迹。

验证

python -m compileall -q src tests examples
python -B -m unittest discover -s tests -v

Roadmap

开源说明

OmniAct 仍在积极开发中。公开仓库保持运行时核心聚焦于任务编排、Worker 边界、任务产物和可读执行轨迹;更大的产品界面会在执行流程稳定后逐步加入。

项目包含经过修改的开源组件,相关署名和许可证信息请查看 THIRD_PARTY_NOTICES.md。

许可证

OmniAct 使用 MIT License 发布。

collab-agent (Iwtbs27/collab-agent)

Searching Database…

Что это такое?OmniAct (репозиторий называется collab-agent) — лёгкая мультиагентная система, помогающая доводить до конца реальные цифровые задачи в браузерах, десктопных приложениях и командной строке.
Это один агент или команда агентов?Это система оркестрации: агент TeamLeader решает, выполнить задачу самому или передать её специализированным агентам-воркерам Browser, CLI или Desktop, каждый из которых ведёт свойственный его среде цикл «наблюдение-действие».
Как её запустить?Создайте окружение Conda/Python 3.11, заполните настройки сервисов моделей в файле .env, затем запустите входящий в комплект скрипт из корня проекта.
Нужны ли API-ключи или дополнительное ПО перед запуском?Да: машина с Windows и установленным Microsoft Edge, Conda или другой менеджер окружений Python, Python 3.11, эндпоинт, совместимый с OpenAI, для вызова инструментов TeamLeader и «зрения» Browser Worker, плюс Codex CLI, если хотите использовать CLI Worker.
Можно ли пользоваться этим как готовым продуктом прямо сейчас?Пока не совсем — работает только на Windows с Microsoft Edge, а публичный репозиторий всё ещё активно разрабатывается и открывает лишь ядро оркестрации, а не полноценный продуктовый UI.
Что на самом деле делает агент TeamLeader?Он отвечает за задачу в целом и делегирует воркерам только чётко очерченные подзадачи; в простых случаях он может сам поразмыслить и ответить напрямую, не дробя работу.
Может ли человек вмешаться, если Worker застрял?Да, воркеры могут приостановиться и передать управление человеку, а в дорожной карте проекта отдельно отмечено повышение надёжности восстановления после человеческого вмешательства или частичных сбоев.
Где найти результаты задачи?Всё попадает в отдельную папку для каждой задачи внутри tasks/, включая описание задачи, запросы и результаты воркеров, скриншоты, файловые артефакты и читаемую трассировку выполнения.
Почему именно CLI Worker требует Codex CLI?CLI Worker управляет возобновляемыми сессиями командной строки через Codex CLI — это CLI-бэкенд, с которым проект сейчас интегрирован.
Creator
Iwtbs27
Size
1 MB
Stars
479
Updated
CommitAug 31
Age
1mo
Commits · 90 Days