Project Info
๐ก
Inspiration
Ever been in a meeting where important decisions and action items get lost in the conversation? We built Helios to automatically transform spoken discussions into visual, interactive knowledge graphs - making it easy to see relationships, track decisions, and never miss important details. ๐
What it does
Helios listens to your conversations through voice AI and automatically generates a live, interactive knowledge graph that: Extracts key entities (people, systems, databases, services) in real-time Identifies relationships between concepts as you speak Tracks decisions and action items automatically Organizes information hierarchically - important nodes at the top, details below ๐ ๏ธ
How we built it
Frontend: React + TypeScript + TailwindCSS for the UI React Flow for interactive graph visualization Vapi SDK for real-time voice transcription and AI conversation Socket.IO client for real-time updates Backend: Node.js + Express server Socket.IO for WebSocket communication OpenRouter API with Google's Gemini Pro for intelligent graph generation Vapi API for voice processing and transcription Custom graph service with intelligent positioning algorithms ๐ VAPI Integration Real-Time Voice-to-Knowledge Graph Pipeline 1. Live Transcription & Conversation Tracking Captured real-time speech-to-text during team discussions Tracked full conversation history with speaker attribution Maintained conversation context throughout entire session 2. AI Assistant Integration Two-way dialogue: Users speak naturally, AI responds with clarifying questions Conversational flow management via Vapi's assistant API Dynamic conversation state handling (started, active, ended events) 3. Streaming Transcript Processing Real-time transcript updates pushed to backend via WebSocket Incremental graph building as conversation progresses Periodic graph refinement every 10 seconds during active recording 4. Multi-Modal Input Support Voice recording through Vapi Web SDK Audio file upload for transcription (supporting async workflows) Session-based recording management 5. Advanced Conversation Analysis Leveraged Vapi's conversation metadata for timestamps Speaker identification for attribution in a knowledge graph Confidence scoring from transcription quality 6. Seamless UX Integration Start/stop recording controls tied to Vapi lifecycle Visual status indicators (listening, processing, finalizing) Toast notifications synced with Vapi conversation events Clean error handling for connection issues Result: Users speak naturally about their ideas, and our AI instantly transforms messy conversations into structured, visual knowledge graphs - all powered by Vapi's robust voice infrastructure. Key Technical Achievement: We went beyond basic transcription by using Vapi as the real-time data source for an intelligent graph-building system, demonstrating Vapi's capability to power complex AI workflows, not just simple voice capture. Key Technical Features: Smart node placement algorithm that organizes by importance (top-to-bottom layout) Real-time position synchronization when users drag nodes Rate limiting and throttling to handle API constraints Collision detection to prevent overlapping nodes WebSocket-based live updates across all connected clients ๐ Accomplishments we're proud of Real-time AI analysis - Processing conversations and updating graphs live with minimal latency Intelligent layout system - Nodes automatically organize by importance with perfect spacing Seamless voice integration - Natural conversation flows directly into visual structures Production-ready architecture - Rate limiting, error handling, and graceful fallbacks ๐
What we learned
Robust schemas are imperative to the full-stack development process as it creates solid foundations to build off of Bring ideas. If you can think it, the tools are there to make it Stick to the MVP. Make something first, then make it better. Not the other way around ๐ฎ
What's next
Persistent storage - Save and reload conversation graphs Advanced AI models - Experiment with different LLMs for better entity extraction Graph analytics - Insights on conversation patterns and key topics Meeting integrations - Connect with Zoom, Teams, or Google Meet Template library - Pre-built graph structures for common meeting types ๐ฏ Built for CalHacks A project showcasing real-time AI, voice technology, and collaborative visualization - turning conversations into actionable insights. ๐ Tech Stack Summary
Tired of important decisions and action items getting lost in meeting conversations?
We built Helios to automatically transform spoken discussions into visual, interactive knowledge graphs.
This makes it easy to see relationships, track decisions, and ensures you never miss an important detail again.
Analysis
View
Metric
- 16
- 5
- 4
- 4
Figures cover GitHub contributors during the hackathon window. A co-authored commit counts in full for each author, so per-member totals add up to more than the whole-team figures.
Technology
- CSSIn code
- ExpressIn code
- HTMLIn code
- JavaScriptIn code
- ReactIn code
- Tailwind CSSIn code
- TypeScriptIn code
- Google GeminiClaimed
- Node.jsClaimed
- OpenAIClaimed
7 of 10 appear in the indexed code. 3 claimed on Devpost could not be matched to code, which may simply mean the tool leaves no trace in the repository.
AI coding agents
No AI coding agent signals were found in this repository.
Detected from committed agent config files and commit authorship. Absence of a signal is not proof an agent was unused.
Codebase size
Source size
339 KB
Source files
85
Counts recognized source files only; vendored directories, binaries and lockfiles are excluded, so this is smaller than the repository on disk.
Repository
yanxue06/Helios
102 files ยท 912 KB ยท @ 1e25a65
Structure
Interface
58 files ยท 57%Screens, components and styles rendered to the user.
Application logic
25 files ยท 25%Domain rules, services and shared utilities.
Supporting
Layers are inferred from where files sit in the tree, not from reading the code. A project that names its directories unconventionally will read oddly here โ open the file browser to check anything the diagram implies.
Languages
- TypeScript97%
- CSS1%
- Markdown1%
- HTML0%
- JavaScript0%
Share of indexed source by file size. Binary and vendored files are excluded.
Dependencies
frontend/package.json
npm ยท 70- @hookform/resolvers
- @radix-ui/react-accordion
- @radix-ui/react-alert-dialog
- @radix-ui/react-aspect-ratio
- @radix-ui/react-avatar
- @radix-ui/react-checkbox
- @radix-ui/react-collapsible
- @radix-ui/react-context-menu
- @radix-ui/react-dialog
- @radix-ui/react-dropdown-menu
- @radix-ui/react-hover-card
- @radix-ui/react-label
- @radix-ui/react-menubar
- @radix-ui/react-navigation-menu
- @radix-ui/react-popover
- @radix-ui/react-progress
- @radix-ui/react-radio-group
- @radix-ui/react-scroll-area
- +52 more
backend/package.json
npm ยท 20- @types/socket.io
- @types/uuid
- @vapi-ai/web
- axios
- cors
- dotenv
- express
- helmet
- morgan
- multer
- socket.io
- uuid
- +8 more
Declared in the repositoryโs manifests at the indexed commit. A declared package is not proof it is used, and runtime dependencies are listed first.
This projectโs features have not been analysed yet.
Export this project's context (description, README, evidence, key source files) to chat with an AI agent elsewhere.