How priyankshu-07/voltmail works
VoltMail’s main user workflow is a Streamlit cold-email form calling an Express API, which builds a prompt, requests Groq generation, sends the message through Gmail, and records success or failure in MongoDB. The repository also contains a separate RAG context-retrieval path using Cohere embeddings and Chroma; sampled UI code does not connect it to email generation. Analytics and campaign tracking are documented, but their data flow is not established by the sampled source, so that relationship is left unverified.
Main entry points: emailController.js Email controller · server.js Express server · chroma_connector.py Vector connector · Voltmail.py Email composer
Components 19
User interface
- Email composer
frontend/pages/Voltmail.py - Analytics dashboard
frontend/pages/analytics.py - API client
frontend/utils/api_handler.py
Email API
- Express server
backend/server.js - Email routes
backend/routes/emailRoutes.js - Email controller
backend/controllers/emailController.js
Generation and delivery
- Prompt builder
backend/services/promptBuilder.js - Groq inference
backend/services/groqService.js - Email sender
backend/services/emailsender.js
Context retrieval
- RAG retrieval
frontend/services/langchain.py - Vector connector
frontend/utils/chroma_connector.py - Chroma store
Persistence and analytics
- Mongo connection
backend/db/mongo.js - Email logs
backend/db/emaillog.js
Other components
- Outreach user
- Groq API
- Gmail delivery
- Cohere embeddings
- MongoDB
Connections 18
- Outreach user → Email composer: enters details
frontend/pages/Voltmail.py - Email composer → API client: submits email
frontend/pages/Voltmail.py - API client → Express server: POSTs request
- Express server → Email routes: mounts routes
backend/server.js - Email routes → Email controller: routes requests
backend/routes/emailRoutes.js - Email controller → Prompt builder: builds prompt
backend/controllers/emailController.js - Email controller → Groq inference: requests generation
backend/controllers/emailController.js - Groq inference → Groq API: calls inference
backend/services/groqService.js - Email controller → Email sender: sends message
backend/controllers/emailController.js - Email sender → Gmail delivery: delivers email
backend/services/emailsender.js - Email controller → Email logs: writes and reads
backend/controllers/emailController.js - Express server → Mongo connection: initializes
backend/server.js - Mongo connection → MongoDB: connects
backend/db/mongo.js - Email logs → MongoDB: stores records
- Outreach user → Analytics dashboard: views metrics
README.md - RAG retrieval → Vector connector: searches context
frontend/services/langchain.py - Vector connector → Chroma store: queries and adds
frontend/utils/chroma_connector.py - Vector connector → Cohere embeddings: embeds documents