jamesob
Featured
local-llm
A comprehensive guide for building and configuring a high-end local machine to run state-of-the-art LLMs, with detailed hardware choices, BIOS tuning, and Docker-based model serving.
Why it is worth attention
It is the pilot project for ByteDance's DeerFlow 3.0, integrates Codex CLI and Bun, and offers both a CLI and programmatic API for creating and running agent-driven workflows.
Who it is for
- Developers building multi-step AI workflows
- Agent and LLM application engineers
- DevOps and CI/CD pipeline architects
- Open-source contributors exploring agent orchestration
Use cases
- Automating deep research with independent angle verification and report synthesis
- Generating blog posts from a topic and audience description
- Creating custom workflows via a bundled Skill and any compatible agent
- Running deterministic orchestration in serverless or event-driven automation
Strengths
- Deterministic TypeScript orchestration ensures reproducible execution
- Replaceable agent runtimes (default Codex CLI, but open to others)
- Interactive TUI for real‑time workflow monitoring and a stable JSON event stream for automation
- Bundled workflow-creator Skill enables agents to generate workflows automatically
Considerations
- Requires the Bun JavaScript runtime (not Node.js)
- The default agent (Codex CLI) must be installed and logged in separately
- Relatively new project; documentation and ecosystem are still evolving
README quick start
deer-workflow
English: README · Guide · API | 简体中文：README · 快速入门 · API
An open-source Dynamic Workflow runtime that combines deterministic TypeScript orchestration with replaceable Agent runtimes.
deer-workflow is a pilot project for
DeerFlow 3.0, also known as
DeerWork. The package name is @deerwork-ai/deer-workflow; the executable is
named deer-workflow.
Index
How to use
Prerequisites
Install Bun and Codex CLI, then sign in:
Bun is a fast, Node.js-compatible JavaScript runtime and toolkit; see its installation guide.
npm install -g @openai/codex
codex login
codex --version
Codex CLI and Codex Desktop are separate installations. Installing the Desktop
app does not install the codex terminal command.
Install the CLI
Install the released CLI from npm:
bun install --global @deerwork-ai/deer-workflow
deer-workflow --help
Running bun install without --global only installs dependencies for the
current project. It does not install the deer-workflow command globally.
Run an Agent
deer-workflow agent "Inspect this repository"
Create a Workflow
Describe the orchestration you need. The command runs the bundled
workflow-creator Skill through Codex and writes generated source to stdout:
deer-workflow create \
"Research several independent angles, verify
Description
An open-source Dynamic Workflow runtime that keeps orchestration in TypeScript and delegates semantic work to replaceable Agent runtimes.
Related repositories
Similar projects matched by category, topics, and programming language.
mereyabdenbekuly-ctrl
Featured
clodex-ide
Clodex is an open-source, local-first agentic IDE that combines persistent AI tasks, code, terminal, browser, Git, models, memory, and governed execution in one Electron workspace, currently in technical preview.
xai-org
Featured
grok-build
Grok Build is SpaceXAI's terminal-based AI coding agent that runs as a full-screen TUI, understands codebases, edits files, executes commands, searches the web, and manages tasks interactively or headlessly.