feros
Getting Started

Local Development

Run feros components individually for day-to-day development.

Local Development

feros is a multi-service monorepo. For most work, run each surface in a separate terminal.

Control Plane API (studio/api)

Run from repo root:

make api-dev
make api-migrate
make api-serve

Useful checks:

make lint-api
make test-api

Dashboard Web (studio/web)

cd studio/web
pnpm install
pnpm dev

Voice Server (voice/server)

cd voice/server
cargo run

This process expects DB connectivity and a valid AUTH__SECRET_KEY.

Voice Engine (voice/engine)

voice/engine is primarily linked as a library dependency for voice/server and studio/api, but you can run tests directly:

cd voice/engine
cargo test

Optional Inference Stack (inference)

Use this only if you want self-hosted STT/TTS:

make inf-build-stt
make inf-build-tts
make inf-stt
make inf-tts

On this page