How dhanushramesh/personal-assistant works
This repository is a Go personal-assistant server. The documented workflow accepts API work, continues it in a background runner, asks a model to reason and invoke tools, then reports progress or completion to listeners. The tree also contains distinct calendar, memory, reminder, profile, speech, and Google-integration domains. The README describes chat and tools as “not started,” which conflicts with the substantial implementation files; the graph includes those modules but avoids asserting unsampled wiring beyond documented relationships and visible startup references.
Main entry points: execute.go Chat runner · main.go Server startup · registry.go Tool registry · api HTTP API
Components 20
Server and API
- Server startup
cmd/server/main.go - HTTP API
internal/api - Authentication
internal/api/authn/authn.go
Assistant execution
- Chat runner
internal/runner/execute.go - Model provider
internal/environment/platformai/client.go - Tool registry
internal/tool/registry.go - Event stream
internal/events/bus.go
Assistant domains
- Chats and conversations
internal/chat - Calendar events
internal/calendar/events.go - Tasks
internal/tasks/tasks.go - Reminders
internal/remind/remind.go - Memory and recall
internal/memory - Personal profile
internal/profile/rhythm.go - Speech
internal/speech/speech.go - Announcements
internal/announcement/announcement.go
Persistence and integrations
- Google account link
internal/google/oauth.go - MySQL storage
internal/storage/storage.go - Chat repository
internal/chat/mysql/repository.go
Other components
- Person or client
- Platform AI
Connections 23
- Person or client → HTTP API: sends request
- HTTP API → Authentication: authenticates
internal/api/authn/authn.go - HTTP API → Chat runner: starts background work
- Chat runner → Model provider: requests model
internal/runner/execute.go - Model provider → Platform AI: sends prompt
internal/environment/platformai/client.go - Chat runner → Tool registry: dispatches tools
internal/runner/execute.go - Chat runner → Event stream: publishes updates
internal/runner/execute.go - HTTP API → Event stream: streams messages
- Chat runner → Chats and conversations: runs chat
internal/runner/execute.go - Server startup → Chat runner: configures
cmd/server/main.go - Server startup → Tool registry: registers tools
cmd/server/main.go - Server startup → MySQL storage: opens database
cmd/server/main.go - Chat repository → MySQL storage: reads and writes
internal/chat/mysql/repository.go - Server startup → Chat repository: constructs repository
cmd/server/main.go - Tool registry → Calendar events: offers calendar tools
- Tool registry → Tasks: offers task tools
- Tool registry → Reminders: offers reminder tools
- Chat runner → Memory and recall: uses recalled context
- Server startup → Google account link: configures account link
- Server startup → Reminders: starts reminder loop
cmd/server/main.go - Server startup → Personal profile: runs profile pass
cmd/server/main.go - Chat runner → Speech: produces speech
- Chat runner → Announcements: announces outcomes