Skip to content

ezpedersen/lahacks2025

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

66 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Ghost Guide

Electron.js React Python FastAPI Google Gemini TypeScript

Alt text

The Problem We're Solving

Have you ever tried to learn Blender, Figma, or CAD software for the first time? If you have, you know the frustration. You open up the program and think: "Where do I even begin?"

So you do what everyone does - you find tutorials. And while tutorials are great for getting a crash course, they come with significant drawbacks:

  • They're often painfully slow (15 minutes to explain a 30-second task)
  • They're frequently over-generalized for broader audiences
  • Many are outdated, showing interfaces that no longer exist
  • You constantly pause, rewind, and switch between windows

This creates a massive learning curve that turns away countless potential users from powerful creative tools.

Our Solution: Ghost Guide

We built Ghost Guide - the first general-purpose tutorial agent that lives directly on your desktop as an invisible layer, guiding you through software in real-time.

Ghost Guide transforms how we learn software by bringing tutorials directly into your workspace.

What Inspired Us

Our journey began when our teammate was recording videos during his internship. Despite his clear instructions and careful recording, people still struggled to follow along. The disconnect between watching a tutorial and implementing the steps is just too great.

We realized there had to be a better way - what if instead of switching between tutorial videos and your software, the tutorial could exist as an overlay on top of your actual workspace?

How Ghost Guide Works

  1. Simple Entry Point: Begin by entering the URL of a tutorial video you would have watched
  2. AI Analysis: Our system uses Gemini 2.5-pro to analyze the video's content and extract structured steps
  3. Checkpoint Creation: The AI creates precise checkpoints for each tutorial step
  4. Desktop Integration: Using Electron, we create an invisible layer over your desktop
  5. Intelligent Positioning: At each checkpoint, we take a screenshot that the AI analyzes to identify coordinate positions
  6. Guided Interface: We overlay intuitive UI elements that point directly to where actions need to be taken

How We Built It

Building Ghost Guide required solving several technical challenges:

  1. We created a desktop client using Electron to build the transparent overlay system
  2. We implemented screenshot analysis that identifies UI elements and their positions
  3. We developed an AI processing pipeline that converts video tutorials into structured checkpoints
  4. We designed a minimalist but effective UI overlay system that guides without distracting

Challenges We Faced

This project pushed us to overcome significant hurdles:

  • Cross-Platform Compatibility: Making our solution work across different operating systems required careful architecture decisions
  • Screen Analysis Precision: Ensuring our AI could accurately identify interface elements across different software was technically challenging
  • Tutorial Extraction: Converting video tutorials into actionable steps required sophisticated AI prompting and processing
  • Performance Optimization: Maintaining smooth performance while running complex AI analysis in the background demanded extensive optimization

What We Learned

Through building Ghost Guide, we've gained invaluable insights:

  • The power of AI in desktop modality integrations.
  • User experience must remain central - even the most advanced technology fails if it's not intuitive
  • Solving the "tutorial gap" has applications far beyond creative software

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •