Docker Compose

One-click setup to run Faramesh with PostgreSQL and Redis.

Quick Start

cd faramesh-horizon-code
docker-compose up -d

cd faramesh-horizon-code
docker-compose up -d

cd faramesh-horizon-code
docker-compose up -d

Faramesh runs at http://localhost:8000. API docs at http://localhost:8000/docs.

What's Included

• Faramesh — API server on port 8000

• PostgreSQL — Database for actions, policies, audit

• Redis — Caching (when enabled)

Run a Demo Agent

Start Faramesh with Docker, then run a demo agent in another terminal:

# Terminal 1: Faramesh
docker-compose up

# Terminal 2: Demo agent
pip install faramesh langchain
export FARAMESH_URL="http://localhost:8000"

# Terminal 1: Faramesh
docker-compose up

# Terminal 2: Demo agent
pip install faramesh langchain
export FARAMESH_URL="http://localhost:8000"

# Terminal 1: Faramesh
docker-compose up

# Terminal 2: Demo agent
pip install faramesh langchain
export FARAMESH_URL="http://localhost:8000"

Or use the interactive demo menu:

cd demo_agents
python run_demos.py
# Choose a demo (1-10) or run "quick" for a 5-minute showcase

cd demo_agents
python run_demos.py
# Choose a demo (1-10) or run "quick" for a 5-minute showcase

cd demo_agents
python run_demos.py
# Choose a demo (1-10) or run "quick" for a 5-minute showcase

Environment Variables

Set these before docker-compose up if needed:

• FARA_AUTH_TOKEN — Optional Bearer token for API auth

• FARA_TENANT_ID — Optional tenant for multi-tenancy

Data Persistence

Data is stored in Docker volumes (postgres-data, redis-data). To reset:

docker-compose down -v
docker-compose up -d

docker-compose down -v
docker-compose up -d

docker-compose down -v
docker-compose up -d