Metadata-Version: 2.4
Name: byoe
Version: 0.8.1
Summary: 卜一智航 — 携智而来，决策随行。AI 开发团队编排 + 内置多模型编程 Agent 一体化工具
Author-email: "byoe.net" <hi@byoe.net>
License-Expression: MIT
Project-URL: Homepage, https://www.byoe.net
Project-URL: Repository, https://github.com/byoenet/byoe
Project-URL: Bug Tracker, https://www.byoe.net/bugs
Project-URL: Changelog, https://www.byoe.net/changelog
Keywords: ai,agent,orchestration,coding,llm,cli,dev-team,byoe
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: openai>=1.0
Requires-Dist: rich>=13.0
Requires-Dist: prompt_toolkit>=3.0
Provides-Extra: dotenv
Requires-Dist: python-dotenv>=1.0; extra == "dotenv"
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Provides-Extra: web
Provides-Extra: fast
Requires-Dist: tiktoken>=0.5; extra == "fast"

﻿# BYOE - Bring Your Own Executive AI

> An AI developer-team orchestration tool by [byoe.net](https://www.byoe.net)

**BYOE** combines a lightweight coding Agent with a Crew orchestration layer, so every developer can have an AI crew standing by at all times.

Website: https://www.byoe.net | Install: `pip install byoe`

## 重要更新（0.8.0）

- **全新杀手级体验！Swarm 自动化群智协作**：在零外部依赖及保障 BYOE 轻巧优雅的前提下，我们上线了内置的、完整的子代理异步接驳体系。主 Agent 现在面对长链条代码结构设计研发与落地任务时，能够自动调用 `swarm_collaboration` 机制，自发串起诸如：”后端架构师 -> 前端交互 -> 代码审计 -> 技术发版文档撰写” 多达29类内置专家的全自动任务流闭环！
- 升级命令：
        ```bash
        pip install -U byoe
        ```

## 历史更新 (0.7.3)

- **技术栈更新和工具集成**： CLI 中使用 `byoe sober` 即可通过原生多文件正则实现项目代码扫描检测，提供 `console/md` 两种输出模式！
- **修复**: 更新了 PyPI 的项目页面元信息，确保链接准确指向 `www.byoe.net`
- 升级命令：
        ```bash
        pip install -U byoe
        ```

## Features

- **AI Coding Agent** — reads/writes files, runs bash commands, searches the web
- **Web UI (Helm)** — React frontend with dark/light theme, session history, token usage
- **CLI** — `byoe chat` for terminal-first workflows
- **Crew Orchestration** — plan and track multi-agent project workflows
- **Any LLM** — OpenAI, Anthropic, DeepSeek, Ollama, or any OpenAI-compatible API
- **Deep Integration** — auto-injects INSTRUCTIONS.md and crew.yaml into the system prompt
- **Session Memory** — save and restore conversations with full token accounting
- **Custom Skills** — extend the agent with your own tools

---

## Installation

```bash
pip install byoe
```

Development install:

```bash
git clone https://github.com/byoenet/byoe
cd byoe
pip install -e .
```

---

## Quick Start

### Web UI

```bash
export OPENAI_API_KEY=sk-...
export BYOE_MODEL=deepseek-chat
byoe web
```

Open http://localhost:7860 in your browser.

### CLI Chat

```bash
export OPENAI_API_KEY=sk-...
export BYOE_MODEL=deepseek-chat
byoe chat
```

### BYOE Hosted Service

```bash
export BYOE_API_KEY=<your-token>
export BYOE_BASE_URL=https://api.byoe.net
byoe web
```

---

## Configuration

Config file: `~/.byoe/config.yaml`

```yaml
provider: openai    # openai | anthropic | deepseek | byoe | ollama
api_key: sk-...
model: gpt-4o
base_url: ""        # optional: custom endpoint
```

Environment variables:

```bash
export BYOE_PROVIDER=openai
export BYOE_API_KEY=sk-...
export BYOE_MODEL=gpt-4o
```

---

## Supported Providers

| Provider | --provider value | Notes |
|----------|-----------------|-------|
| OpenAI | openai | GPT-4o, o1, etc. |
| Anthropic | anthropic | Claude 3.5 Sonnet, etc. |
| DeepSeek | deepseek | deepseek-chat, deepseek-coder |
| Ollama | ollama | Local models |
| BYOE | byoe | Hosted service at byoe.net |
| Any OpenAI-compat | openai + --base-url | LM Studio, vLLM, etc. |

---

## Crew Commands

```bash
byoe init              # Initialize project (creates INSTRUCTIONS.md + crew.yaml)
byoe plan "<goal>"     # Generate a sprint plan
byoe status            # Show current sprint / task status
byoe release           # Tag and document a release
byoe run               # Execute the next planned task
byoe agents            # List available specialist agents
```

---

## License

MIT (c) byoe.net
