local-studio
| Name | Last commit date |
|---|---|
| .githooks | 6 months ago |
| .github | 7 months ago |
| cli | 6 months ago |
| controller | 6 months ago |
| frontend | 6 months ago |
| scripts | 6 months ago |
| .env.example | 6 months ago |
| .gitignore | 6 months ago |
| AGENTS.md | 6 months ago |
| CHANGELOG.md | 6 months ago |
| docker-compose.yml | 6 months ago |
| LICENSE | 10 months ago |
| package-lock.json | 7 months ago |
| package.json | 6 months ago |
| README.md | 7 months ago |
| release.config.cjs | 6 months ago |
vLLM Studio
Unified local AI workstation for model lifecycle, chat/agent workflows, orchestration, observability, and remote deployment.
Release: v1.13.0
This release consolidates major repo changes currently in the tree, including:
- OpenAI proxy activation policy controls for
load_if_idleandswitch_on_request - lifecycle-aware run aborts when model eviction happens
- SSE run stream termination fixes across backend and frontend
- local-only chat/runtime cleanup and controller simplification
- dashboard launch-state cleanup improvements
- reduced chat/controller indirection and removed dead remote-runtime branches
Docs
- Overview: docs/README.md
- Setup and deployment: docs/operations.md
- Environment variables: docs/environment.md
Repository layout
controller/: Bun/Hono backend, orchestration, chat runtime, lifecycle, metricsfrontend/: Next.js app, chat UI, proxy endpoints, client statecli/: Bun CLI for controller accessshared/: shared types/contractsconfig/: runtime and integration configsdocs/: documentation index and environment notesscripts/: operational scripts (deployment + controller daemon helpers)docker-compose.yml: full stack service definitionsscripts/daemon-*.sh: start/status/stop helpers for background controller runs
Quick start
- Controller (local):
cd controller
npx tsc --noEmit
bun test
bun src/main.ts
- Frontend:
cd frontend
npm run test
npm run lint
npm run build
npm run dev
- Full stack with Docker (controller + frontend + infra):
docker compose up -d --build controller frontend
- Run controller as a background daemon:
./scripts/daemon-start.sh
./scripts/daemon-status.sh
./scripts/daemon-stop.sh
Health checks
curl -sS http://localhost:8080/health
curl -I http://localhost:3000
API docs
- http://localhost:8080/api/docs
- http://localhost:8080/api/spec
Setup guide
See docs/operations.md for setup, deployment, and verification instructions.
Branching and release workflow
- Development branch:
dev - Production integration branch:
main - Release tags:
vX.Y.Z
For this release:
- merge release work into
mainanddev - tag
v1.13.0 - create a new post-release working branch