Skip to content

HackSignal

A database tool for hackathon participants seeking inspiration on how winning teams use sponsor APIs.

Code Video Cerebral Valley

Core trick

Agents propose database edits that are queued as diffs and applied only after a user accepts or declines each change.

Tags

dev toolsagents

Description

A database tool for hackathon participants seeking inspiration on how winning teams use sponsor APIs. Features a sidebar listing hackathons (discovered via web search agents), with drill-down views showing teams per hackathon -- winners are highlighted. Insight agents analyze overall sponsor API usage patterns across each hackathon and surface interesting projects. Each project includes an API analysis agent that describes how sponsor APIs are specifically used within that team's submission, catching non-obvious integrations. Web search agents can find new hackathons, import team project description URLs, or accept pasted descriptions for a summary agent to generate project cards. All agent-proposed updates go through human-in-the-loop approval, letting users accept or decline changes before they're applied.
alice-gjw/HackSignal★ 00 forksPythonCreated Mar 7, 2026 · last push Mar 7, 2026

README excerpt

# HackSignal

Multi-agent intelligence platform for analyzing how hackathon teams use sponsor APIs. Discover patterns, explore winning projects, and understand API adoption across hackathons.

## Features

- **Sponsor API Analytics** - See which APIs are most popular and how winning teams use them
- **Project Explorer** - Browse hackathon projects with detailed tech stacks and descriptions
- **Smart Import** - Paste Devpost URLs or project info to auto-extract and add data
- **AI-Powered Summaries** - Generates comprehensive project descriptions from raw data
- **Cross-Hackathon Search** - Auto-detects which hackathon a project belongs to

## Tech Stack

**Backend:**
- Python 3.11+ with FastAPI
- Google Gemini API for LLM features
- uv for dependency management

**Frontend:**
- React 18 with Vite
- Framer Motion for animations
- CSS variables for theming

## Prerequisites

- Python 3.11+
- Node.js 18+
- [uv](https://github.com/astral-sh/uv) (Python package manager)
- Google Gemini API key

## Setup

### 1. Clone and install dependencies

```bash
# Clone the repo
git clone <repo-url>
cd HackSignal

# Install Python dependencies
uv sync

# Install frontend dependencies
cd frontend
npm install
cd ..
```

### 2. Configure environment

Create a `.env` file in the project root:

```env
GEMINI_API_KEY=your_gemini_api_key_here
```

### 3. Add hackathon data

Create the data directories and add your hackathon JSON files:

```bash
mkdir -p data/exported data/analyzed data/discovered
``

Team