local-dev

Local development environment setup and commands. Use when helping with dev server, Docker, or local testing.

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/local-dev/SKILL.md

Local Development

Quick Start

./scripts/dev-runner.sh --restart   # First time / full rebuild
./scripts/dev-runner.sh --start     # Daily start (no rebuild)
./scripts/dev-runner.sh --stop      # Stop everything
./scripts/dev-runner.sh --verify    # Check status

Modes

Mode	Command	Frontend	Use When
Standard	`--restart`	localhost:5174	Frontend work, full-stack
BE-only	`--be-only-restart`	localhost:5173	Backend-focused, faster rebuilds
Platform (EM)	`PLATFORM_ENABLED=true ./scripts/dev-runner.sh --restart`	localhost:9100	Opik-team only: run Opik connected to the Comet Platform

Platform (EM) mode — Opik-team only

PLATFORM_ENABLED=true runs the Comet EM/Platform stack (comet-backend + comet-react, auto-detected sibling checkouts) alongside Opik behind a single-origin nginx proxy, with Opik in comet mode authenticating/resolving workspaces via comet-backend. Off by default — Standard/BE-only dev is unaffected. comet-backend builds under a detected JDK 17/21; Opik still uses JDK 25.

PLATFORM_ENABLED=true ./scripts/dev-runner.sh --restart   # then also --start/--stop/--verify
# Integrated UI:  http://localhost:9100        (comet-react / Platform)
#                 http://localhost:9100/opik   (Opik, comet mode)

Env vars (COMET_BACKEND_PATH, COMET_REACT_PATH, PLATFORM_JAVA_HOME, PLATFORM_*_PORT) and --platform-build are documented in ./scripts/dev-runner.sh --help.

URLs

Frontend: localhost:5174 (standard) / localhost:5173 (BE-only)
Backend API: localhost:8080
Health: http://localhost:8080/health-check?name=all

Build Commands

./scripts/dev-runner.sh --build-be   # Backend only
./scripts/dev-runner.sh --build-fe   # Frontend only
./scripts/dev-runner.sh --lint-be    # Spotless
./scripts/dev-runner.sh --lint-fe    # ESLint
./scripts/dev-runner.sh --migrate    # DB migrations

Logs

tail -f /tmp/opik-backend.log        # Backend
tail -f /tmp/opik-frontend.log       # Frontend (standard)
docker logs -f opik-frontend-1       # Frontend (BE-only)

SDK Config

export OPIK_URL_OVERRIDE='http://localhost:8080'
export OPIK_WORKSPACE='default'

Troubleshooting

Won't start:

./scripts/dev-runner.sh --verify
lsof -i :8080                        # Port conflict?
./scripts/dev-runner.sh --stop && ./scripts/dev-runner.sh --restart

Build fails:

cd apps/opik-backend && mvn clean install -DskipTests
cd apps/opik-frontend && rm -rf node_modules && npm install

Database issues:

./scripts/dev-runner.sh --stop
./opik.sh --clean                    # WARNING: deletes data
./scripts/dev-runner.sh --restart

Repository: comet-ml/opik
Path: .agents/skills/local-dev/SKILL.md
Commit: aae4650

Last updated: 5 days ago
First committed: 23 days ago

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.