by baidu-baige
LoongFlow: A Thinking & Learning Framework for Expert-Grade AI Agents.
# Add to your Claude Code skills
git clone https://github.com/baidu-baige/LoongFlowSet Creativity Free! LoongFlow turns your expertise into professional AI productivity.
LoongFlow is an open-source expert-grade Agent development framework.
Enable Agents to think and learn through the PES paradigm, and accumulate experience through iteration.
🚀 Quick Start • Examples • Math-Agent • ML-Agent • General-Agent • Discussions
LoongFlow: Inspired by Wang Yangming's "Enlightenment at Longchang".LoongFlow is dedicated to breaking the barrier between Knowing and Doing. We enable wisdom to awaken through the unity of knowledge and action, ensuring that every drop of professional expertise is transformed into powerful AI productivity.
An expert-grade Agent framework that thinks and learns. It empowers Agents to think like scientists, helping developers rapidly transform their professional expertise into expert-level Agents.
No comments yet. Be the first to share your thoughts!
We believe that the key to designing an expert-level Agent capable of solving complex problems lies in the Agent’s thinking paradigm. The thinking paradigm determines the complexity of problems an Agent can handle and sets the ceiling for its effectiveness. LoongFlow is built specifically for complex tasks requiring long-range reasoning, helping developers rapidly build Agents with domain-expert performance.
| Domain | Achievement | Example | | ------------------------------------------------------ |----------------------------------------------------------------------------------------------------------------------------------| ------------------------------------------------------------------------------------------------------ | | Mathematical Challenges (Tao’s & AlphaEvolve sets) | Outperformed the best human results on 11 problems and surpassed AlphaEvolve’s results on 7 problems, achieving the latest SOTA. | Circle Packing | | MLE-bench (Kaggle Challenges) | Achieved medals across all 48 Kaggle competitions, including 26 Gold Medals. | Stanford-Covid-Vaccine |
LoongFlow requires Python 3.12 or higher.
# Install uv/conda and clone repository
uv: https://docs.astral.sh/uv/getting-started/installation/
Miniforge: https://conda-forge.org/download/
# Install with uv
cd LoongFlow
uv venv .venv --python 3.12
source .venv/bin/activate
uv pip install -e .
# Install with conda
cd LoongFlow
conda create -n loongflow python=3.12
conda activate loongflow
pip install -e .
# Config LLM: Edit task_config.yaml or set environment variables
# Supports Anthropic-compatible models
export ANTHROPIC_API_KEY="your-api-key"
export ANTHROPIC_BASE_URL="your-endpoint"
# Run beginner example - TODO list app (5-10 minutes)
./run_general.sh 01_todo_list
# Run intermediate example - File processor with custom skills (10-15 minutes)
./run_general.sh 02_file_processor
# Run advanced example - Bug hunter with security scanning (15-20 minutes)
./run_general.sh 03_bug_hunter
# Run expert example - Circle packing optimization (20-30 minutes)
./run_general.sh 04_circle_packing --background
# Check task log (for background tasks)
tail -f ./agents/general_agent/examples/04_circle_packing/run.log
# Stop background task
./run_general.sh stop 04_circle_packing
# 📖 Complete Tutor