Skip to content

A local-first multi-agent app development platform, built on PenguinHarness

Update README.md

lihengfba193a37191
diff --git a/README.md b/README.md
index 7298afe3..b8e901c4 100644
--- a/README.md
+++ b/README.md
@@ -28,183 +28,3 @@
<p align="center">English | <a href="README.zh.md">简体中文</a></p>
-## Why Adelie
-
-> With LangChain, you build agents by hand — at 1× speed.<br />With Adelie, agents build agents — at 100×.
-
-Adelie runs on your computer or server and automates the agent app lifecycle from creation and evaluation to optimization and deployment. Three reasons define the platform:
-
-### 1. 🏆 Outstanding results at tens of times less cost
-
-A deliberately minimal toolset over clean low-level interfaces: fewer tool calls, fewer tokens — deeply tuned for open models like DeepSeek. Each harness on the model it is normally paired with, same tasks, head-to-head:
-
-<p align="center">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="assets/readme/benchmark-dark.svg" />
- <img src="assets/readme/benchmark-light.svg" alt="Benchmark: Adelie leads the data-analysis suite and ties OpenAI Codex on coding, at a small fraction of both rivals' cost" width="920" />
- </picture>
-</p>
-
-**Best accuracy on data analysis — at 1/70 of Claude Code's cost.**
-
-### 2. ⚡ One sentence generates a runnable agent app
-
-Describe what you need in one sentence. Adelie builds the complete agent application — scaffold, code, and run instructions, end to end:
-
-```text
-Collect the docs from https://github.com/ericbuess/claude-code-docs and build a RAG app that answers Claude Code questions as a configuration expert, citing its sources.
-```
-
-And this is the finished product — a docs expert with retrieval, cited sources that link to the original files, and example questions built in:
-
-https://github.com/user-attachments/assets/9b7033e8-f08a-4c3f-bd33-547896664e6e
-
-**And generating this entire RAG app burned just $0.02 (¥0.2) of tokens — on DeepSeek V4 Pro.**
-
-### 3. 🧬 Native agent self-evolution engine
-
-With Adelie Skills, an agent evaluates and optimizes itself: run the benchmark, find the lost points, ship version N+1 — with a snapshot before every round and every request observable in the Trace view.
-
-https://github.com/user-attachments/assets/922d13a6-5ffc-4685-9a39-352f02f9afc0
-
-*The benchmark and the two recordings above are the upstream PenguinHarness authors' own results and screen captures of this codebase — Adelie ships that same engine and UI, so they describe what this fork does. The product name visible in the recordings is the base's pre-rename branding.*
-
-## Built-in plugins
-
-Four plugin categories ship in the box (the docs live in [`packages/docs`](packages/docs) in this tree) — skills, plus the session hooks that drive goal mode and continual learning; agents can also write and optimize their own skills:
-
-| Category | Plugins |
-| -------------------- | ----------------------------------------------------------------------------- |
-| Office Productivity | `data-analysis`, `use-firecrawl`, `browser-automation`, `use-bento-slides`, `humanizer`, `goal`, `continual-learning` |
-| Software Development | `software-development`, `use-claude-code` |
-| AI App Development | `agent-development`, `model-development`, `skill-porting`, `agent-tuning` |
-| Agent Company | `agent-company` |
-
-The desktop app also has a built-in browser in its side dock. Agents drive it with `penguin browser` and the `browser-automation` plugin: they read pages, click and type, and pull out data such as your Amazon orders, signed in with the accounts you import from your own browser.
-
-## Supported Models
-
-| Model | Providers |
-| ---------------- | ------------------------------------------------------------------------------------------------ |
-| DeepSeek V4 | DeepSeek, OpenRouter, Fireworks AI, SiliconFlow, TokenDance, Qwen Token Plan, Qwen Pay-As-You-Go |
-| Kimi K3 | Moonshot AI, OpenRouter, Fireworks AI, TokenDance, Qwen Pay-As-You-Go |
-| GLM 5.3 | Z.AI, OpenRouter, TokenDance |
-| Hunyuan 3 | OpenRouter |
-| Qwen 3.8 Max | Qwen Token Plan, Qwen Pay-As-You-Go, OpenRouter, TokenDance |
-| GPT 5.6 | OpenAI, OpenRouter |
-| Gemini 3.7 Flash | Google Gemini, OpenRouter |
-| Claude 5 | Anthropic, OpenRouter |
-| Inkling | OpenRouter, Fireworks AI |
-
-Each family's latest generation only — the app's **Models** page lists every built-in preset, and any OpenAI-protocol endpoint works too: pick a preset, or point a custom endpoint at any of the 1000+ online and local models.
-
-## Requirements
-
-| Requirement | Supported |
-| ------------ | -------------------------------------------------------------------------- |
-| OS | Linux, macOS, Windows 10+ |
-| Architecture | x64, arm64 |
-| Runtime | Node >= 24 (there is no Adelie installer yet — see Installation) |
-| Model | an API key for at least one model |
-
-## Installation — read this first
-
-**Adelie has not shipped release artifacts of its own yet.** There is no Adelie npm package, no
-Adelie installer, no Adelie Docker image and no Adelie download page: those are the last step of the
-plan ([`FORK-PROGRESS.md`](FORK-PROGRESS.md) §4). Today the only way to run Adelie is from this
-source tree:
-
-```bash
-# dependencies (skip desktop/electron: it downloads a runtime and is not needed for the Web App)
-pnpm install --frozen-lockfile \
- --filter @prismshadow/penguin-core --filter @prismshadow/penguin-ui \
- --filter @prismshadow/penguin-server --filter @prismshadow/penguin-web \
- --filter @prismshadow/penguin-cli --filter @prismshadow/penguin-hmr
-
-# build (core's exports point at dist/, so build before running anything)
-pnpm -r --filter @prismshadow/penguin-core --filter @prismshadow/penguin-server \
- --filter @prismshadow/penguin-web run build
-
-# run the server together with the built Web App
-cd packages/server
-PENGUIN_HOME=<data root> HOST=0.0.0.0 PORT=<port> node dist/index.js
-```
-
-The first start prints a first-login link as a framed notice on every start until a password exists —
-open it to claim the built-in `admin` account and set one (there is no initial password to copy).
-Models are configured on the in-app **Models** page, which is where a fresh instance needs an API key
-before it can run anything.
-
-> [!WARNING]
-> Everything the upstream README offers — `curl https://penguin.ooo/install.sh | sh`,
-> `npm install -g @prismshadow/penguin-cli`, `docker run hiyouga/penguinharness`, the desktop
-> installer on <https://penguin.ooo/download> — installs **PenguinHarness**, not Adelie. Those
-> channels stay upstream's until Adelie publishes its own.
-
-Package names, the data root and the command name still carry the upstream spelling
-(`@prismshadow/*`, `~/.penguin/data`, `penguin`) because the rename is a staged job — what is left
-of it is tracked in [`FORK-PROGRESS.md`](FORK-PROGRESS.md).
-
-## Development
-
-```bash
-pnpm install && pnpm build # build first: core's exports point at dist/
-pnpm dev # backend + web app together (prefixed logs, deps built once)
-```
-
-See [CONTRIBUTING.md](.github/CONTRIBUTING.md) for the workspace guide (the file is upstream's and
-largely still describes this tree accurately): dev commands, quality gates, repo layout, changelog
-rule. `packages/landing` (the upstream website) was removed in this fork.
-
-## Upstream roadmap
-
-This is the upstream project's roadmap, kept here as context for where
-the base is heading. Adelie's own plan is [`FORK-PROGRESS.md`](FORK-PROGRESS.md).
-
-- [ ] Public release of the benchmark suite
-- [x] Desktop app
-- [x] Windows support
-- [ ] Agent company and templates
-- [ ] Company-level self evolving
-- [ ] OpenShell integration (permission-governed shell)
-- More to come…
-
-## Upstream contributors
-
-Thanks to everyone who has contributed to PenguinHarness — the
-codebase this fork is built on.
-
-<p align="center">
- <a href="https://github.com/Prism-Shadow/penguin-harness/graphs/contributors"><img src="https://contrib.rocks/image?repo=Prism-Shadow/penguin-harness" alt="PenguinHarness contributors" /></a>
-</p>
-
-## Citation
-
-If you use this codebase in your research, cite the upstream project it comes from (Adelie is a
-fork of it):
-
-```bibtex
-@software{penguinharness2026,
- author = {{PrismShadow Team}},
- title = {PenguinHarness: Efficient Self-Improving Harness for Everyone},
- year = {2026},
- url = {https://github.com/Prism-Shadow/penguin-harness},
- license = {Apache-2.0}
-}
-```
-
-## Acknowledgements
-
-This repo benefits from:
-
-- [MinGit](https://github.com/git-for-windows/git): the POSIX shell and Git bundled on Windows
-- [GenericAgent](https://github.com/lsdefine/genericagent): built-in browser automation
-
-See [THIRD-PARTY-NOTICES.md](THIRD-PARTY-NOTICES.md) for their licenses.
-
-## License
-
-[Apache-2.0](LICENSE) © 2026 Prism Shadow — the upstream copyright. Adelie is a fork of it and
-is released under the same licence; see [`FORK.md`](FORK.md).
-
-The upstream PenguinHarness codebase is built with ❤️ by [Yaowei Zheng](https://github.com/hiyouga) (author of [LlamaFactory](https://github.com/hiyouga/LlamaFactory)), the [PrismShadow AI Team](https://github.com/Prism-Shadow), and [Fable 5](https://www.anthropic.com/news/claude-fable-5-mythos-5). Adelie is a fork of that work.