Skip to content
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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/suyash728--hackathon-starter/badge.svg)](/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
  1. # <Project name>
  2. > <one-line pitch>
  3. ```mermaid
  4. flowchart LR
  5. UI[Next.js 14 UI<br/>trace panel] -->|REST + SSE| API[FastAPI]
  6. API --> G[LangGraph agent]
  7. G --> R{llm.py router}
  8. R -->|1| Groq[Groq gpt-oss-120b]
  9. R -->|2 on 429/timeout| Gem[Gemini Flash-Lite]
  10. R -->|3 offline / Privacy Mode| V[vLLM local GPU]
  11. API --> DB[(Supabase Postgres + pgvector)]
  12. ```
  13. ## Quickstart
  14. ```bash
  15. cp .env.example .env # fill keys
  16. cd backend && uv sync && cd ..
  17. cd frontend && npm ci && cd ..
  18. bash scripts/dev.sh # API :8787, UI :3000
  19. bash scripts/smoke_demo.sh
  20. ```
  21. ## Env vars
  22. `GROQ_API_KEY`, `GEMINI_API_KEY`, `VLLM_BASE_URL`, `VLLM_MODEL`, `PRIVACY_MODE`,
  23. `SUPABASE_URL`, `SUPABASE_ANON_KEY`, `NEXT_PUBLIC_API_URL`, `CORS_ORIGINS`
  24. ## Rubric alignment
  25. | Criterion | Where to see it |
  26. |---|---|
  27. | <criterion> | <screen / demo second> |
  28. ## Works offline
  29. Toggle **Privacy Mode**: every model call goes to a local vLLM server on the presenter's GPU.
  30. ## AI disclosure
  31. See [AI_DISCLOSURE.md](AI_DISCLOSURE.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.