Imagine having a team of AI assistants that actually understand your needs and work together seamlessly. Hushh AI Agent Ecosystem is a collection of smart AI agents that help you with email marketing, research, calendar management, and remembering important details about your relationships—all while keeping your privacy secure.
git clone https://github.com/AAK121/Hushh_Hackathon_Team_Mailer.git
cd Hushh_Hackathon_Team_Mailer
pip install -r requirements.txt
# Start the backend server (in background)
start powershell -ArgumentList "-NoExit", "-Command", "cd 'C:\Users\Dell\Hushh_Hackathon_Team_Mailer'; python api.py"
# Start the frontend (in another terminal)
cd frontend
npm install
npm run dev
-
Smart AI Agents That Work Together
Four specialized AI assistants that share context and work as a team to help you get things done. -
Your Data Stays Private
Everything is encrypted and you control what data each agent can access. No surprises, no hidden data collection. -
Intelligent and Personalized
Our agents learn your preferences and get better at helping you over time, while respecting your privacy.
What it does:
- Creates personalized emails for your contacts
- You review and approve every email before it's sent
- Learns from your feedback to get better over time
- Handles email lists from Excel/CSV files
Why it's special:
- Goes beyond just inserting names - creates relevant content based on what each person actually cares about
- Human review required - you stay in control
- Gets smarter over time with your feedback
📖 Complete MailerPanda Documentation
What it does:
- Remembers important information about your contacts
- Shares context with other agents for better personalization
- Helps you maintain better relationships by tracking preferences and history
- Keeps all information private and secure
Why it's special:
- Agents work together with shared context
- Complete privacy control - you decide what to remember
- Never forget important details about people you care about
📖 Complete Relationship Memory Documentation
What it does:
- Automatically finds events and dates in your emails
- Adds events to your Google Calendar
- Manages meeting schedules and reminders
- Understands natural language when creating events
Why it's special:
- No more manual calendar entry
- Understands context and natural language
- Seamless Google Calendar integration
📖 Complete AddToCalendar Documentation
What it does:
- Searches multiple sources for comprehensive information
- Finds academic papers, news articles, and reliable sources
- Summarizes complex information in easy-to-understand format
- Helps with fact-checking and research projects
Why it's special:
- Multiple source verification
- Academic-quality research capabilities
- Clear, understandable summaries
📖 Complete Research Agent Documentation
- Complete Technical Documentation - Comprehensive technical specifications
- Complete API Reference - API documentation for all agents
- Agent Architecture - How each agent works
- Setup Guide - Get started in 5 minutes
- 📧 MailerPanda Agent - Smart email marketing
- 🧠 Relationship Memory Agent - Contact management
- 📅 AddToCalendar Agent - Calendar management
- 🔍 Research Agent - Information gathering
Each agent has its own functions you can call. Send requests with your data and get intelligent responses. All communication is secure and encrypted.
Example - Creating an Email Campaign:
{
"user_id": "user_123",
"personalization": "high"
}Backend:
- Python FastAPI - Fast and reliable server
- Google Gemini AI - Latest AI technology for smart responses
- Strong Security - Data encryption and privacy controls built-in
Frontend:
- React & TypeScript - Modern, reliable web interface
- Real-time Updates - See what's happening as it happens
- Responsive Design - Works on all devices
Security & Privacy:
- Data Encryption - Your information is always protected
- User Control - You decide what data to share and when
- No Hidden Collection - Complete transparency about data usage
- Python 3.8 or newer
- A Google API key for the AI features
- Email service credentials (like Mailjet for sending emails)
# Get the code
git clone https://github.com/AAK121/Hushh_Hackathon_Team_Mailer.git
cd Hushh_Hackathon_Team_Mailer
# Set up Python environment
python -m venv .venv
# Windows
.\.venv\Scripts\Activate
# Mac/Linux
source .venv/bin/activate
# Install what you need
pip install -r requirements.txt
# Add your API keys
cp .env.example .env
# Edit .env with your API keys# Add these to your .env file
GOOGLE_API_KEY=your_gemini_api_key
MAILJET_API_KEY=your_mailjet_api_key
MAILJET_API_SECRET=your_mailjet_secret# Start the main server (in background)
start powershell -ArgumentList "-NoExit", "-Command", "cd 'C:\Users\Dell\Hushh_Hackathon_Team_Mailer'; python api.py"
# Visit http://127.0.0.1:8001 to use the agents
# For the web interface (in another terminal)
cd frontend
npm install
npm run dev
# Visit http://localhost:3000 for the web dashboard- Swagger UI: http://127.0.0.1:8001/docs - Interactive API testing
- ReDoc: http://127.0.0.1:8001/redoc - Detailed API reference
- 6 Working AI Agents - Each one specializes in different tasks
- Simple Privacy Controls - You decide what data to share
- Modern Web Interface - Easy to use dashboard and controls
- Complete Documentation - Everything you need to get started
- Production Ready - Built to handle real users and real work
- Agents Work Together - They share information to help you better
- Privacy First - Your data stays secure and under your control
- Easy to Use - No technical knowledge required
- Open Source - You can see exactly how it works
- Community Driven - Built with feedback from real users
Our agents are fast and reliable:
- MailerPanda: Creates 100 emails per minute
- Research Agent: Handles 50 searches per minute
- Calendar Agent: Manages 150 events per minute
Ready to try AI agents that actually respect your privacy?
# Get it running in 5 minutes
git clone https://github.com/AAK121/Hushh_Hackathon_Team_Mailer.git
cd Hushh_Hackathon_Team_Mailer
pip install -r requirements.txt
# Start backend (in background)
start powershell -ArgumentList "-NoExit", "-Command", "cd 'C:\Users\Dell\Hushh_Hackathon_Team_Mailer'; python api.py"
# Open http://127.0.0.1:8001 in your browser- GitHub: Star us and contribute
- Documentation: Complete guides and tutorials
- Issues: Report bugs or request features
- Email: Get help and support
Made with ❤️ for everyone who believes in privacy
"Your data, your agents, your control."