git404hub

what is circuit-framework fr?

ethanxiang777/circuit-framework — explained in plain English

Analysis updated 2026-05-18

488PythonAudience · researcherComplexity · 3/5LicenseSetup · moderate

tl;dr

A research tool where multiple AI agents debate crypto market data and propose simulated paper trades, checked by a rule-based risk system before approval.

vibe map

mindmap
  root((Circuit Framework))
    What it does
      Multi-agent crypto analysis
      Simulated paper trading
      Deterministic risk checks
      No real trades placed
    Tech stack
      Python
      LangGraph
      SQLite
      Hyperliquid data API
    Use cases
      Research trading strategies
      Test paper portfolios
      Compare strategy profiles
      Study AI agent debate
    Audience
      Researchers
      Quant enthusiasts
      Developers
    Setup
      Install with pip
      Add LLM API key
      Run CLI commands

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Research how a team of AI agents would analyze a cryptocurrency before trading it.

VIBE 2

Run simulated paper trades on symbols like BTC or ETH without risking real money.

VIBE 3

Compare different strategy profiles such as momentum or derivatives-focused.

VIBE 4

Study how a deterministic risk engine can filter AI trading proposals.

what's the stack?

PythonLangGraphSQLiteHyperliquid API

how it stacks up fr

ethanxiang777/circuit-frameworkcvlab-kaist/videomamaicex0/wp2shell-poc
Stars488489485
LanguagePythonPythonPython
Last pushed2026-04-01
MaintenanceMaintained
Setup difficultymoderatehardeasy
Complexity3/54/54/5
Audienceresearcherdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires an API key from an LLM provider such as OpenAI or Anthropic to run live analysis.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

Circuit Framework is a research tool that simulates cryptocurrency trading using a team of AI agents that debate with each other before deciding whether to make a trade. It is a fork of an earlier project called TradingAgents, adapted specifically for crypto markets. The README is very clear that this is for research only, not financial advice, and that it never places real trades or connects to a real exchange account. When you ask it to analyze a coin like BTC or ETH, several specialized AI agents look at different angles of the market: price and order book structure, derivatives data like funding rates, social sentiment, news catalysts, and the overall market regime such as trend and volatility. Two more agents then argue the bullish and bearish case against each other, and a research manager weighs their arguments. A trader agent proposes a trade of going long, going short, or doing nothing, and a separate rule-based risk system checks that proposal against safety limits before deciding whether to approve it, size it, or reject it. Nothing is left purely to the AI's judgment at that final step. Users interact with it through a command line tool, running commands like analyzing a symbol with a chosen strategy profile, or checking their simulated paper trading portfolio and position history. Several ready-made strategy profiles exist, such as balanced, momentum, and derivatives-focused, which change the agents' weighting without changing the underlying data pipeline. All trades in this framework are simulated on a local paper trading database, not real money. The project supports many different AI providers behind the scenes, including OpenAI, Anthropic, Google, and several others, so users can choose which AI model powers the analysis. It also keeps the original stock market analysis mode from the project it was forked from, covering fundamentals, sentiment, news, and technical analysis for stocks. It is built in Python and licensed under the Apache License 2.0.

prompts (copy fr)

prompt 1
Help me install Circuit Framework and run my first paper trade analysis on BTC.
prompt 2
Explain the difference between the balanced and momentum strategy profiles in Circuit Framework.
prompt 3
Walk me through how the deterministic risk gate decides to approve or reject a trade proposal.
prompt 4
Show me how to add my Anthropic API key so Circuit Framework can use Claude for analysis.
prompt 5
Explain what each of the five crypto analyst roles focuses on in this framework.

Frequently asked questions

what is circuit-framework fr?

A research tool where multiple AI agents debate crypto market data and propose simulated paper trades, checked by a rule-based risk system before approval.

What language is circuit-framework written in?

Mainly Python. The stack also includes Python, LangGraph, SQLite.

What license does circuit-framework use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is circuit-framework to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is circuit-framework for?

Mainly researcher.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.