Headlong is a framework for human users to create and curate high quality chain-of-thought datasets and use them in AI Agents.

The webapp frontend is in packages/webapp - it's a vite Typescript project.

The webapp depends on a thought_server (found in packages/thought_server) which is written in Python and wraps LLMs for thought generation.

The environment is in packages/env - it's a node daemon written in Typescript. you should run this in a docker container or EC2 instance.

The environment uses GPT4 function calling to use tools, including a terminalServer that itself wraps ht (headless terminal).

The webapp communicates with the environment via a Supabase thoughts table and Supabase's realtime system.

### == ht ==
# Download latest ht binary from https://github.com/andyk/ht/releases/latest
# and make sure it is on your path.

### == thought server ==
# in a new terminal 
cd packages/thought_server
# You need python >= 3.10 since we use the `match` syntax. 
virtualenv venv
. ./venv/bin/activate
pip install -r requirements.txt
# make sure you create or get a copy of thinkers.yaml and put it into ./
. ./launch.sh

### == headlong UI webapp ==
cd packages/webapp
npm install
npm run dev

## By default your webapp will connect to the main env running in EC2
## via supabase realtime. If you want to override that and use a local
## env, then you'll need to run the terminalServer and env locally.
## We strongly recommend you run these in a docker instance.

### == terminal server ==
# in a new terminal 
cd packages/env
npm install
npm run terminalServer

### == env daemon ==
# in a new terminal 
cd packages/env
npm run env