Back to search
hackathon-starter
SkillWorks with Claude CodeGitHub
Hackathon template: FastAPI + LangGraph + Next.js 14, 3-tier LLM router (Groq/Gemini/local vLLM), agent trace panel, Claude Code skills
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/suyash728--hackathon-starter)HTML
<a href="/listings/suyash728--hackathon-starter"><img src="/api/listings/suyash728--hackathon-starter/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
cp .env.example .env # fill keys cd backend && uv sync && cd .. cd frontend && npm ci && cd .. bash scripts/dev.sh # API :8787, UI :3000 bash scripts/smoke_demo.sh
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 38 lines
- # <Project name>
- > <one-line pitch>
- ```mermaid
- flowchart LR
- UI[Next.js 14 UI<br/>trace panel] -->|REST + SSE| API[FastAPI]
- API --> G[LangGraph agent]
- G --> R{llm.py router}
- R -->|1| Groq[Groq gpt-oss-120b]
- R -->|2 on 429/timeout| Gem[Gemini Flash-Lite]
- R -->|3 offline / Privacy Mode| V[vLLM local GPU]
- API --> DB[(Supabase Postgres + pgvector)]
- ```
- ## Quickstart
- ```bash
- cp .env.example .env # fill keys
- cd backend && uv sync && cd ..
- cd frontend && npm ci && cd ..
- bash scripts/dev.sh # API :8787, UI :3000
- bash scripts/smoke_demo.sh
- ```
- ## Env vars
- `GROQ_API_KEY`, `GEMINI_API_KEY`, `VLLM_BASE_URL`, `VLLM_MODEL`, `PRIVACY_MODE`,
- `SUPABASE_URL`, `SUPABASE_ANON_KEY`, `NEXT_PUBLIC_API_URL`, `CORS_ORIGINS`
- ## Rubric alignment
- | Criterion | Where to see it |
- |---|---|
- | <criterion> | <screen / demo second> |
- ## Works offline
- Toggle **Privacy Mode**: every model call goes to a local vLLM server on the presenter's GPU.
- ## AI disclosure
- See [AI_DISCLOSURE.md](AI_DISCLOSURE.md).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.