How notwitcheer/portal-assistant works
portal-assistant is a Hermes Agent profile for personal-assistant chats, not a standalone application. A user chats through a supported client or messaging platform; Hermes runs the profile, applies its behavioral instructions and configured tools, and uses the main or task-specific models to respond. The profile emphasizes reminders, personal planning and notes, with confirmation before external actions. The repository contains configuration and profile instructions rather than runtime source, so this map shows only README-documented relationships; the exact internal execution flow is not visible.
Main entry points: config.yaml Main model · distribution.yaml Profile distribution · SOUL.md Assistant instructions
Components 12
Profile behavior
- Assistant instructions
SOUL.md - Reminder tools
config.yaml - Action approvals
config.yaml
Runtime settings
- Hermes Agent
- Profile configuration
config.yaml - Profile distribution
distribution.yaml - Main model
config.yaml - Auxiliary models
config.yaml
Chat channels
- Chat clients
- Messaging platforms
Other components
- Assistant user
- Model providers
Connections 13
- Assistant user → Chat clients: chats through
README.md - Assistant user → Messaging platforms: chats through
README.md - Chat clients → Hermes Agent: connect to
README.md - Messaging platforms → Hermes Agent: deliver messages
README.md - Profile distribution → Profile configuration: packages settings
README.md - Hermes Agent → Assistant instructions: follows
README.md - Hermes Agent → Profile configuration: uses
README.md - Hermes Agent → Main model: handles turns
README.md - Hermes Agent → Reminder tools: uses
README.md - Hermes Agent → Action approvals: checks actions
README.md - Hermes Agent → Auxiliary models: uses for side tasks
README.md - Main model → Model providers: calls
README.md - Auxiliary models → Model providers: calls
README.md