# Dev Servers

> Start the backend (FastAPI/uvicorn) and frontend (Vite) development servers. Use when user mentions "start dev", "run servers", "launch app", "start the app", or needs to run the application locally.

- Skill: `aiskillstore/dev-servers` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add aiskillstore/dev-servers`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aiskillstore/dev-servers/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: aiskillstore (https://skillmd.com/u/aiskillstore)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/aiskillstore/dev-servers

---


# Development Servers

## Instructions
1. Check if dependencies are installed:
   - Backend: Look for `backend/venv/` or ask user about Python environment
   - Frontend: Check if `frontend/node_modules/` exists

2. Install dependencies if missing:
   - Backend: `cd backend && pip install -r requirements.txt`
   - Frontend: `cd frontend && npm install`

3. Start servers (recommend running in separate terminals or background):
   - Backend: `cd backend && uvicorn main:app --reload` (runs on http://localhost:8000)
   - Frontend: `cd frontend && npm run dev` (runs on http://localhost:5173)

4. Verify `.env` file exists in `backend/` with `OPENAI_API_KEY` set

## Examples
- "Start the dev servers"
- "Run the app locally"
- "Launch backend and frontend"

## Guardrails
- Never expose or log the OPENAI_API_KEY
- Confirm with user before installing dependencies
- Warn if ports 8000 or 5173 are already in use