How ruxakk/friday_jarvis works
Friday is a personal AI assistant centered on a LiveKit agent session: a user interacts by voice and video, the session starts the assistant and generates an opening reply, and the assistant can use weather, web-search, and email tools. The assistant’s persona and session behavior come from prompts.py; tools.py implements the three integrations. The README also advertises web-app chat and vision, but the supplied tree contains no web-app implementation. The map reflects only the shown agent and tool code; other advertised capabilities may be implemented elsewhere or remain undocumented here.
Main entry points: agent.py Friday assistant · tools.py Weather lookup · prompts.py Instructions
Components 15
LiveKit session
- LiveKit runtime
- Agent entrypoint
agent.py - Agent session
agent.py - Video input
agent.py - Noise cancellation
agent.py
Assistant behavior
- Friday assistant
agent.py - Instructions
prompts.py
Assistant tools
- Weather lookup
tools.py - Web search
tools.py - Email sending
tools.py
External services
- Google realtime model
- wttr.in
- DuckDuckGo search
- Gmail SMTP
Other components
- User
Connections 16
- User → Agent session: interacts with
README.md - LiveKit runtime → Agent entrypoint: runs worker
agent.py - Agent entrypoint → Friday assistant: creates
agent.py - Agent entrypoint → Agent session: starts
agent.py - Agent entrypoint → Agent session: generates reply
agent.py - Agent session → Friday assistant: runs
agent.py - Agent session → Video input: enables
agent.py - Agent session → Noise cancellation: configures
agent.py - Friday assistant → Instructions: uses instructions
agent.py - Friday assistant → Google realtime model: configures model
agent.py - Friday assistant → Weather lookup: registers tool
agent.py - Friday assistant → Web search: registers tool
agent.py - Friday assistant → Email sending: registers tool
agent.py - Weather lookup → wttr.in: requests weather
tools.py - Web search → DuckDuckGo search: searches query
tools.py - Email sending → Gmail SMTP: sends email
tools.py