How bkashjee/hermes-bot-forge works
Bot Forge is a Hermes plugin for creating and operating Bots (Hermes profiles) from chat requests. The main flow dispatches tool calls through tools.py to forge.py, which builds a profile and its persona, memory, capabilities, routines, chat, and gateway. Other product branches manage existing Bots and teams, share templates, teach skills, maintain journals, and provide health checks and turn acknowledgements. Some subsystem links are based on README capabilities because the corresponding implementation excerpts were not sampled.
Main entry points: tools.py Tool handlers · forge.py Profile builder · team.py Team builder · portable.py Template handling
Components 17
Plugin interface
- Tool handlers
tools.py
Bot construction
- Profile builder
forge.py - Bot profile
- Team builder
team.py - Taught skills
skills
Bot operations
- Bot management
manage.py
Bot runtime support
- Work journal
journal.py - Profile journal files
- Workspace survey
survey.py - Install doctor
doctor.py - Turn acknowledgements
marks/tapback.py
Portability
- Template handling
portable.py - Bundled templates
templates
Other components
- Chatting agent
- Hermes platform
- Message reaction tool
- Hermes gateway
Connections 21
- Chatting agent → Tool handlers: requests tools
- Tool handlers → Profile builder: runs builder
- Tool handlers → Team builder: runs team builder
- Team builder → Profile builder: builds members
- Profile builder → Bot profile: creates profile
- Profile builder → Hermes gateway: installs gateway
- Profile builder → Hermes platform: starts Bot Chat
- Tool handlers → Bot management: dispatches management
- Bot management → Bot profile: updates profiles
- Tool handlers → Work journal: dispatches journal
- Work journal → Profile journal files: reads and writes
- Tool handlers → Template handling: dispatches sharing
- Template handling → Bot profile: exports and imports
- Template handling → Bundled templates: loads templates
- Tool handlers → Taught skills: saves procedures
- Team builder → Bot profile: records team roster
- Install doctor → Bot profile: checks installation
- Install doctor → Hermes gateway: checks gateway
- Turn acknowledgements → Message reaction tool: dispatches reaction
- Hermes platform → Turn acknowledgements: runs turn hooks
- Workspace survey → Bot profile: reads Bot context