How shubhagarwal-03/raphael works
Raphael is a local, offline-first command-line assistant. Its main workflow takes user input through intent handling, memory and rule actions, then planning and tool execution; unmatched requests can fall back to Ollama. Major branches include app control, web search, music playback, calculation, and persistent and semantic memory. The README documents the search-manager ordering, but no such file appears in the tree, so that orchestration is represented as part of main.py. Edges reflect shown imports/calls or README claims; some internal dispatch details are not visible in the excerpts.
Main entry points: main.py Intent and response flow · tool_executor.py Tool execution · planner.py Task planner · memory.json Persistent memory
Components 15
Input and orchestration
- Intent and response flow
main.py - Task planner
planner.py
Memory and rules
- Memory commands
main.py - Persistent memory
memory.json - Semantic cache
memory/semantic_cache.py - Rule checks
rule_engine.py
Tools and actions
- Calculator
tools/compute.py - Tool execution
tool_executor.py - Song cache
memory/song_cache.py
Local runtime
- App registry
config.py - Process launcher
executor.py
Other components
- User
- Ollama model
- Chrome browser
- YouTube search
Connections 14
- User → Intent and response flow: enters command
ReadMe.md - Intent and response flow → Task planner: plans task
ReadMe.md - Task planner → Tool execution: routes tool
ReadMe.md - Intent and response flow → Memory commands: handles memory
ReadMe.md - Memory commands → Persistent memory: reads and writes
ReadMe.md - Intent and response flow → Semantic cache: looks up answers
main.py - Intent and response flow → Calculator: uses calculator
main.py - Intent and response flow → Ollama model: falls back
ReadMe.md - Intent and response flow → Rule checks: checks blocks
main.py - Tool execution → App registry: finds app
tool_executor.py - Tool execution → Process launcher: launches command
tool_executor.py - Tool execution → Song cache: reads and writes
tool_executor.py - Tool execution → YouTube search: searches tracks
ReadMe.md - Tool execution → Chrome browser: opens results
tool_executor.py