Welcome to CHIA’s documentation!

CHIA is an open-source framework for agile and principled hardware/software co-design research — where humans, agents, and existing hardware-design tools all work together.

New to CHIA? Start with the CHIA Basics page, or go straight to Installation to set things up.

The current release of CHIA is considered a beta. If you find any issues, please reach out to us via the user forum or contact the lead developers / PI (Angela Cui, Ferran Hermida-Rivera, Jack Toubes, and Sagar Karandikar).

CHIA stands for:

(Co-designing Hardware and software with Intelligent Agents)

Originally CHIA stood for:

(CHipyard’s Intelligent Agents)

(CHipyard’s Intelligence Agency)

Getting Started

• CHIA Basics
• Installation
  • Optional extras
  • Core dependencies
  • Next steps
• Quickstart: Say Hello (World) with CHIA
  • What we will do in this tutorial
  • Requirements
  • 0. Project Setup
  • 1. print() ing Hello from a worker
  • 2. Print Hello in Verilator
  • 3. Asking an LLM to say Hello
  • 4. Editing RTL to say Hello

Concepts

• Architecture Overview
  • CHIA loops
  • CHIA clusters
  • Fault tolerance & reproducibility
  • Infrastructure

User Guides

• ChiaFunction
  • A few Ray concepts
  • Executing a CHIA node
  • Collecting results
  • Worker-side setup and cleanup hooks
  • Defining your own node
  • Wrapping actors (chia_actor)
  • Cross-cutting features
  • See also
• ChiaTool
  • A few MCP concepts
  • Anatomy of a tool
  • The tool lifecycle
  • Bridging tools back to nodes
  • Defining your own tool
  • Tool placement and resources
  • Advanced
  • See also
• Cluster Configuration Reference
  • Top-level structure
  • provider
  • auth
  • available_node_types
  • Cloud nodes
  • A mixed on-prem + cloud example
  • Command execution order
• Setting up logical workers
  • What a logical worker is
  • Anatomy of a worker definition
  • Dockerized vs. non-dockerized workers
  • Controlling the execution environment
  • Verifying the environment
  • Placement and scaling
  • Lifecycle
  • Common pitfalls
  • See also
• Building a CHIA-compatible Docker image
  • What “CHIA-compatible” means
  • Extend a CHIA base image with your tool
  • Extend your tool image with CHIA
  • Wiring the image into a cluster
  • Pitfalls
  • See also
• Caching and Bypass
  • Tags
  • Bypass
  • Cache
  • Putting it together: populate, then replay
• Profiling
  • Enabling profiling
  • What gets recorded
  • Attaching custom metadata
  • Visualizing a profile
• Example: Agentic RoCC Accelerator (MemCpy)
  • What it does
  • Components
  • The accelerator contract
  • Running it
  • Tunable parameters
  • Debug feedback
  • Output and per-iteration diffs

Case Studies

• gem5-BOOM Microarchitecture Alignment
  • Overview
  • How it works
  • Setup
• RISC-V ISA Extension Implementation
  • Overview
  • How it works
  • Setup
• BOOM Critical-Path Timing Optimization
  • Overview
  • How it works
  • Setup
• Autonomous CIRCT Issue Solving
  • Overview
  • How it works
  • Setup

CLI Reference

• CLI Reference
  • Cluster management
  • Visualization
  • Jobs
  • FireSim

API Reference

• Base Runtime
  • Bypass
  • Cache
  • Chia Function
  • Chia Wait
  • Chia KV Store
  • Colocated
  • Dispatch Proxy
  • PID Registry
  • LLM Call
  • MCP tool servers
• Chipyard Nodes
  • State definitions
  • Chisel build
  • CIRCT
  • Macro compiler
  • Chipyard / Hammer
  • RISC-V build
  • RISC-V objdump
  • RISC-V DV generation
  • Torture
  • Verilator run
  • Spike cosim
• ESP Support
  • The worker
  • Simulation
  • Vivado and the FPGA flow
  • Resources as license seats
  • API reference
• Model Backends
  • Claude
  • Bedrock
  • Vertex
  • Antigravity
  • Codex
  • Copilot
  • Opencode
  • Openai Compat
  • Openai Providers
  • Ollama
  • vLLM
• FireSim
  • Config
  • Chia Functions
  • State Def
• VLSI
  • Hammer
  • SRAM characterization (CACTI)
• Databases
  • Base
  • Postgres Node
  • Sqlite Node
• GitHub
  • Github Client
  • Github Issues Node
  • Github Pulls Node
  • State Def
• AWS
  • Config
  • EC2
  • Host
  • S3
• Simulators
  • gem5
• Analysis
  • Focal
  • PFAS
• LLM servers, providers, and agent Nodes
  • Base class
  • Providers

Indices and tables

• Index

• Search Page