local-studio
| Name | Last commit date |
|---|---|
| .factory | 8 months ago |
| .github | 7 months ago |
| cli | 8 months ago |
| config | 8 months ago |
| controller | 7 months ago |
| docs | 8 months ago |
| frontend | 7 months ago |
| scripts | 7 months ago |
| shared | 8 months ago |
| skills | 8 months ago |
| website | 7 months ago |
| .env.example | 8 months ago |
| .gitignore | 7 months ago |
| AGENTS.md | 8 months ago |
| CHANGELOG.md | 8 months ago |
| docker-compose.yml | 8 months ago |
| LICENSE | 10 months ago |
| README.md | 8 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
- Daytona toolbox reliability hardening (route fallback, quota cleanup retry, alias-safe command parsing)
- dashboard launch-state cleanup improvements
- expanded controller/daytona test coverage for run termination and toolbox behavior
Docs
- Overview: docs/README.md
- Setup and deployment: setup/README.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 accessswift-client/: iOS/macOS client (XcodeGen)shared/: 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 setup/README.md for complete 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