How emiwe3/wavelength works
Wavelength is a student-focused personal assistant that gathers academic and campus information, answers text-based requests, and sends proactive reminders through iMessage. The main interactive flow is the frontend connecting accounts and registering a phone, then backend request handling invoking the agent, which builds cached student context, fetches connected-source data, and returns a response or action. A separate scheduler drives deadline alerts and briefings. The README documents additional image/video, calendar, location, and personalization capabilities; unsampled implementation details and some integration wiring are not asserted beyond that documentation.
Main entry points: agent.py Claude assistant · scheduler.py Reminder scheduler · context.py Student context · db.py User and context store
Components 24
User experience
- Connection dashboard
frontend/src/App.jsx - Connection status
frontend/src/components/StatusCard.jsx
Assistant runtime
- HTTP and auth API
backend/main.py - Claude assistant
backend/agent.py - Student context
backend/context.py - User and context store
backend/db.py - Message bot
backend/bot.py
Academic sources
- Canvas data
backend/canvas.py - Calendar feed sync
backend/calendar_sync.py - Gmail data
backend/gmail.py - Slack sync
backend/slack_sync.py
Actions and reminders
- Calendar event writer
backend/calendar_write.py - Reminder scheduler
backend/scheduler.py - Message delivery
backend/messenger.py - iMessage bridge
backend/imessage.py - Audio transcription
backend/audio.py - Travel estimates
backend/maps.py
Other components
- Student
- Canvas service
- Google services
- Slack service
- Photon iMessage
- iCal feed
- Google Maps
Connections 32
- Student → Connection dashboard: connects accounts
README.md - Connection dashboard → HTTP and auth API: calls API
frontend/src/App.jsx - Connection dashboard → Connection status: renders status
frontend/src/App.jsx - HTTP and auth API → User and context store: stores registration
backend/main.py - HTTP and auth API → Claude assistant: requests reply
backend/main.py - Claude assistant → Student context: builds context
backend/agent.py - Claude assistant → User and context store: reads cache and preferences
backend/agent.py - Student context → Calendar feed sync: fetches events
backend/context.py - Student context → Canvas data: fetches coursework
backend/context.py - Student context → Gmail data: fetches emails
backend/context.py - Student context → Slack sync: fetches announcements
backend/context.py - Student context → User and context store: refreshes credentials
backend/context.py - Calendar feed sync → iCal feed: reads feed
- Canvas data → Canvas service: retrieves assignments
- Gmail data → Google services: retrieves messages
- Slack sync → Slack service: retrieves posts
- Claude assistant → Calendar event writer: creates events
backend/agent.py - Calendar event writer → Google services: writes calendar
- Claude assistant → Audio transcription: uses transcription
backend/agent.py - Claude assistant → Travel estimates: gets travel details
backend/agent.py - Travel estimates → Google Maps: estimates travel
- Reminder scheduler → User and context store: loads users
backend/scheduler.py - Reminder scheduler → Canvas data: checks assignments
backend/scheduler.py - Reminder scheduler → Calendar feed sync: checks events
backend/scheduler.py - Reminder scheduler → Claude assistant: drafts reminders
backend/scheduler.py - Reminder scheduler → Travel estimates: gets travel estimates
backend/scheduler.py - Reminder scheduler → Message delivery: sends briefings
backend/scheduler.py - Message delivery → Photon iMessage: delivers messages
- Message bot → Claude assistant: requests replies
backend/bot.py - Message bot → User and context store: loads user data
backend/bot.py - Message bot → iMessage bridge: handles messages
backend/bot.py - iMessage bridge → Photon iMessage: bridges messaging