How sabarishpv/minipulse works
MiniPulse is a two-service Slack bot for answering natural-language questions about HubSpot CRM data. A Slack mention is verified and deduplicated by the adapter, which forwards the question and thread ID to the AI service; the service applies guardrails and preserves per-thread history, then Gemini selects read-only CRM tools and returns an answer for posting into the Slack thread. The tools share a single HubSpot client. README documents the service boundary and tool capabilities; some internal tool-to-client details are supported by sampled source and the SOURCE INDEX, while unsampled implementation details are not inferred.
Main entry points: __init__.py Tool registry · hubspot/client.py HubSpot client · llm/client.py Gemini tool loop · main.py Event adapter
Components 18
Slack adapter
- Event adapter
slack-adapter/app/main.py
AI orchestration
- Ask API
ai-service/app/main.py - Conversation service
ai-service/app/ai_service.py - Thread history
ai-service/app/ai_service.py - Gemini tool loop
ai-service/app/llm/client.py - System prompt
ai-service/app/llm/system_prompt.py
CRM query tools
- Tool registry
ai-service/app/tools/__init__.py - Count by stage
ai-service/app/tools/deals.py - Search deals
ai-service/app/tools/search.py - Contact lookup
ai-service/app/tools/contacts.py - Deal owner
ai-service/app/tools/owners.py - Recent deal summary
ai-service/app/tools/summary.py - New companies
ai-service/app/tools/companies.py
External integrations
- Slack events
- HubSpot client
ai-service/app/hubspot/client.py - HubSpot CRM API
- Gemini API
Other components
- Slack user
Connections 23
- Slack user → Slack events: asks in
README.md - Slack events → Event adapter: delivers event
README.md - Event adapter → Ask API: forwards question
slack-adapter/app/main.py - Ask API → Conversation service: calls
ai-service/app/main.py - Conversation service → Thread history: loads and saves
ai-service/app/ai_service.py - Conversation service → Gemini tool loop: runs conversation
ai-service/app/ai_service.py - Gemini tool loop → System prompt: configures with
ai-service/app/llm/client.py - Gemini tool loop → Gemini API: calls
README.md - Gemini tool loop → Tool registry: dispatches tools
ai-service/app/llm/client.py - Tool registry → Count by stage: registers
ai-service/app/tools/__init__.py - Tool registry → Search deals: registers
ai-service/app/tools/__init__.py - Tool registry → Contact lookup: registers
ai-service/app/tools/__init__.py - Tool registry → Deal owner: registers
ai-service/app/tools/__init__.py - Tool registry → Recent deal summary: registers
ai-service/app/tools/__init__.py - Tool registry → New companies: registers
ai-service/app/tools/__init__.py - Count by stage → HubSpot client: queries
ai-service/app/tools/deals.py - Search deals → HubSpot client: queries
ai-service/app/tools/search.py - Contact lookup → HubSpot client: queries
ai-service/app/tools/contacts.py - Deal owner → HubSpot client: queries
ai-service/app/tools/owners.py - Recent deal summary → HubSpot client: queries
ai-service/app/tools/summary.py - New companies → HubSpot client: queries
ai-service/app/tools/companies.py - HubSpot client → HubSpot CRM API: requests CRM data
README.md - Event adapter → Slack events: posts reply
slack-adapter/app/main.py