# Project export: Pulse Desktop pet

This document was generated by HackStack to give an AI agent context about a hackathon project. Sections are labeled with their provenance; content marked as truncated was cut to keep this document small.

## Project metadata

- Hackathon: UC Berkeley AI Hackathon 2026
- Tagline: Pulse is an event-driven AI desktop pet built with Python and GPT-4o-mini to combat procrastination, using dual-personality behavioral correction to optimize developer workflow.
- Devpost: https://devpost.com/software/pulse-desktop-pet
- GitHub: not linked
- Video: https://www.youtube.com/embed/UfLYtioQFVg?enablejsapi=1&hl=en_US&rel=0&start=&version=3&wmode=transparent
- Team: contributor stats unavailable

## Devpost submission (written by the team)

### Inspiration

The inspiration for Pulse comes from a universal problem among developers: procrastination and burnout. Traditional productivity tools rely on passive dashboards and gentle notifications, which are easily ignored. We wanted to create an interactive solution that injects dynamic engagement directly into the workspace. By designing an event-driven desktop companion, we explore how an AI can utilize contrasting behavioral archetypes to effectively correct work habits while providing emotional grounding during high-stress periods.

### What it does

Pulse is a native desktop pet featuring a dual-personality state machine powered by a reactive LLM: Pulse Mode (Behavioral Correction): Spontaneously triggers or responds to user inputs using strict prompt engineering to deliver high-pressure, witty motivational correction to deter slacking. Comfort Mode (Psychological Grounding): Toggles instantly via the UI to shift into an empathetic persona, providing supportive, calming dialogue to alleviate developer stress and anxiety. The pet also leverages background tracking to spontaneously drift from the screen edge based on random jitter logic to maintain interactive presence.

### How we built it

Frontend Architecture: Built natively in Python using the Tkinter library, engineering custom window attributes to achieve a borderless, draggable, and transparent floating UI that overlays seamlessly on any active workspace. Backend AI Integration: Integrated the OpenAI API (GPT-4o-mini). We constructed rigorous system instructions to enforce consistent, structured JSON outputs, syncing the model's emotional state directly with our custom UI art assets. Concurrency Management: Utilized Python’s threading module and asynchronous event loops to offload heavy API network requests, ensuring seamless UI rendering without thread-blocking latency.

### Challenges we ran into

Tkinter operates on a strict single thread. Routing real-time, asynchronous LLM payloads back to the UI thread without causing application crashes required implementing secure queueing and callback logic. Furthermore, to prevent frontend breakage, we spent significant effort engineering prompt constraints to guarantee the LLM strictly adheres to valid JSON, mitigating the risk of unparsable formatting errors.

### Accomplishments we're proud of

Engineering a highly responsive, end-to-end asynchronous event system loop in a native Python desktop app. Successfully implementing a reliable persona state-machine that handles instantaneous transitions between contrasting conversational behaviors. Designing and embedding original custom visual assets dynamically responsive to real-time LLM state telemetry.

### What we learned

We mastered the design paradigm of "Prompt-Driven UIs," where an LLM doesn't merely spit out text but directly orchestrates the visual states, asset choices, and animations of the frontend. We also deepened our understanding of asynchronous thread isolation in native desktop programming.

### What's next

for Pulse We plan to introduce local vision model integration to dynamically analyze the workspace screen for active procrastination (e.g., active IDE vs. video streaming) and engineer direct IDE plugins (like VS Code extensions) to provide context-aware syntax error critique.

## README (from the GitHub repository)

No README available.

## Detected evidence (automated analysis)

No repository was indexed for this project. Claimed technologies below could not be checked against code.
- Python (language) — claimed on Devpost, not found in the code

## Codebase structure

No repository index available.

## Key source files

No repository index available; no source files included.