Metadata-Version: 2.4
Name: byoe
Version: 0.5.8
Summary: 卜一智航 — 携智而来，决策随行。AI 开发团队编排 + 内置多模型编程 Agent 一体化工具
Author-email: 卜一智元 <hi@byoe.net>
License-Expression: MIT
Project-URL: Homepage, https://byoe.net
Project-URL: Repository, https://github.com/Titanicacidhorn810/JetBot
Project-URL: Bug Tracker, https://byoe.net
Project-URL: Changelog, https://byoe.net
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://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://byoe.net | Install: `pip install 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
byoe web --provider openai --api-key sk-...
```

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

### CLI Chat

```bash
byoe chat --provider openai --api-key sk-...
```

### BYOE Hosted Service

```bash
byoe web --provider byoe --byoe-token <your-token>
```

---

## 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
