Manual Self-Hosting - Helicone OSS LLM Observability

Warning

Deploy with Docker Compose! We recommend deploying with Docker Compose, as it works easily with just one line.

Note we moved the old manual setup with Supabase here

At Helicone we believe that open-source software makes the world a better place. We are committed to open-source and we made a guide to make it easy for you to deploy your own instance of Helicone.

Running locally#

Running Helicone locally should be super easy. Just a few scripts.

Please clone our Repo and follow the instructions below.

git clone git@github.com:Helicone/helicone.gitcd helicone

Step 1 - Install all the things#

Requirements

Docker

Install Yarn#

nvm install 20nvm use 20npm install -g yarn

Step 2 - Start all the services#

Start Databases#

python3 -m venv envsource env/bin/activatepip install tabulate requests minio yarl# Start Clickhouse (time-series database)python3 clickhouse/ch_hcone.py --restart --no-password --url http://localhost:18123# Start Minio (S3 compatible object storage)python3 minio_hcone.py --restart# Start Postgresdocker run -d --name helicone-postgres-flyway-test -e POSTGRES_DB=helicone_test -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=testpassword -p 54388:5432 -v postgres_flyway_data:/var/lib/postgresql/data postgres:17.4flyway migrate -configFiles=supabase/flyway.conf

Start mailhog server (local email testing)#

docker run -p 1025:1025 -p 8025:8025 mailhog/mailhog

Start Jawn (Backend + Main Proxy)#

In a new terminal tab, run the following:

nvm use 20cd valhalla/jawncp .env.example .envyarn && yarn dev

Start Web#

In a new terminal tab, run the following:

nvm use 20cp .env.example web/.envcd webyarnyarn dev:local -p 3000

Step 3 - Setup your instance#

You are done!

curl http://localhost:8585/healthcheck

Note

Jawn no longer proxies LLM traffic: the /v1/gateway/* routes have been removed. To proxy requests through a self-hosted deployment, run the AI Gateway alongside Jawn.

You can login to Helicone at http://localhost:3000 with the following credentials:

User: test@helicone.ai Password: password

Change the Org to Organization for Test and then you should be able to see your requests!

Please do not hesitate to reach out on discord if you have any questions.