{"id":48289804,"url":"https://github.com/yashab-cyber/zeo","last_synced_at":"2026-04-04T23:02:50.228Z","repository":{"id":306444749,"uuid":"1019107569","full_name":"yashab-cyber/zeo","owner":"yashab-cyber","description":"A complete AI-powered client acquisition and engagement system built for ZehraSec, a cybersecurity company. This system includes lead generation, client engagement (chatbot), product recommendation, CRM, analytics dashboard, and email automation.","archived":false,"fork":false,"pushed_at":"2025-07-25T14:59:12.000Z","size":103,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-25T20:53:07.332Z","etag":null,"topics":["ai","artificial-intelligence","ethicalhacking","python","python3"],"latest_commit_sha":null,"homepage":"https://zehrasec.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yashab-cyber.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-13T18:48:50.000Z","updated_at":"2025-07-25T14:57:35.000Z","dependencies_parsed_at":"2025-07-25T20:53:12.072Z","dependency_job_id":"16dcf4e6-441d-4d64-b81b-4e1543c73436","html_url":"https://github.com/yashab-cyber/zeo","commit_stats":null,"previous_names":["yashab-cyber/zeo"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/yashab-cyber/zeo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashab-cyber%2Fzeo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashab-cyber%2Fzeo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashab-cyber%2Fzeo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashab-cyber%2Fzeo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yashab-cyber","download_url":"https://codeload.github.com/yashab-cyber/zeo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashab-cyber%2Fzeo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31418287,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T20:09:54.854Z","status":"ssl_error","status_checked_at":"2026-04-04T20:09:44.350Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","artificial-intelligence","ethicalhacking","python","python3"],"created_at":"2026-04-04T23:02:12.009Z","updated_at":"2026-04-04T23:02:50.220Z","avatar_url":"https://github.com/yashab-cyber.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ZehraSec AI-Powered Client Acquisition System\r\n\r\nA complete AI-powered client acquisition and engagement system built for ZehraSec, a cybersecurity company. This system includes lead generation, client engagement (chatbot), product recommendation, CRM, analytics dashboard, and email automation.\r\n\r\n## 🚀 Features\r\n\r\n### Core Features\r\n- **AI-Powered Chatbot**: Intelligent conversation handling with OpenAI integration\r\n- **Lead Generation**: Automated lead capture and scoring system\r\n- **CRM Integration**: Complete customer relationship management\r\n- **Email Automation**: Automated email campaigns and nurture sequences\r\n- **Analytics Dashboard**: Real-time insights and performance metrics\r\n- **Product Recommendations**: AI-driven product suggestions\r\n- **Appointment Scheduling**: Integrated booking system\r\n- **Real-time Chat**: WebSocket-based live communication\r\n\r\n### Technical Features\r\n- **Flask Backend**: RESTful API with comprehensive endpoints\r\n- **SQLite Database**: Local storage with ORM-like data models\r\n- **WebSocket Support**: Real-time communication with Socket.IO\r\n- **Modern UI**: Bootstrap-based responsive design\r\n- **Admin Dashboard**: Complete management interface\r\n- **Export Functionality**: CSV/PDF export capabilities\r\n- **Search \u0026 Filtering**: Advanced search and filtering options\r\n\r\n## 🛠️ Technology Stack\r\n\r\n### Backend\r\n- **Python 3.8+**\r\n- **Flask 2.3.3** - Web framework\r\n- **SQLite** - Database\r\n- **OpenAI API** - AI integration\r\n- **Socket.IO** - Real-time communication\r\n- **Pandas** - Data processing\r\n- **Scikit-learn** - Machine learning\r\n\r\n### Frontend\r\n- **HTML5/CSS3/JavaScript**\r\n- **Bootstrap 5.1.3** - UI framework\r\n- **Chart.js** - Data visualization\r\n- **Font Awesome** - Icons\r\n- **Socket.IO Client** - Real-time communication\r\n\r\n### Dependencies\r\n- Flask-SQLAlchemy\r\n- Flask-CORS\r\n- Flask-SocketIO\r\n- OpenAI\r\n- Requests\r\n- Schedule\r\n- APScheduler\r\n- And more (see requirements.txt)\r\n\r\n## 📁 Project Structure\r\n\r\n```\r\nzeo/\r\n├── app.py                 # Main Flask application\r\n├── config.py              # Configuration settings\r\n├── models.py              # Database models and ORM\r\n├── requirements.txt       # Python dependencies\r\n├── routes/\r\n│   ├── api_routes.py      # REST API endpoints\r\n│   ├── chat_routes.py     # Chat functionality\r\n│   └── dashboard_routes.py # Admin dashboard\r\n├── services/\r\n│   ├── ai_service.py      # AI and OpenAI integration\r\n│   ├── analytics_service.py # Analytics and reporting\r\n│   ├── crm_service.py     # CRM functionality\r\n│   ├── email_service.py   # Email automation\r\n│   └── lead_service.py    # Lead management\r\n├── templates/\r\n│   ├── index.html         # Main website\r\n│   ├── chat.html          # Chat interface\r\n│   └── admin/\r\n│       ├── dashboard.html # Admin dashboard\r\n│       ├── leads.html     # Lead management\r\n│       ├── analytics.html # Analytics page\r\n│       └── campaigns.html # Email campaigns\r\n└── static/\r\n    ├── css/\r\n    │   ├── style.css      # Main website styles\r\n    │   └── admin.css      # Admin dashboard styles\r\n    └── js/\r\n        ├── main.js        # Main website scripts\r\n        └── admin.js       # Admin dashboard scripts\r\n```\r\n\r\n## 🔧 Installation \u0026 Setup\r\n\r\n### Prerequisites\r\n- Python 3.8 or higher\r\n- pip (Python package manager)\r\n- OpenAI API key (optional, for AI features)\r\n\r\n### 1. Clone the Repository\r\n```bash\r\ngit clone \u003crepository-url\u003e\r\ncd zeo\r\n```\r\n\r\n### 2. Create Virtual Environment\r\n```bash\r\npython -m venv venv\r\nsource venv/bin/activate  # On Windows: venv\\Scripts\\activate\r\n```\r\n\r\n### 3. Install Dependencies\r\n```bash\r\npip install -r requirements.txt\r\n```\r\n\r\n### 4. Configure Environment Variables\r\nCreate a `.env` file in the root directory:\r\n```env\r\nSECRET_KEY=your-secret-key-here\r\nOPENAI_API_KEY=your-openai-api-key\r\nDATABASE_URL=sqlite:///zehrasec.db\r\nEMAIL_HOST=smtp.gmail.com\r\nEMAIL_PORT=587\r\nEMAIL_USER=your-email@gmail.com\r\nEMAIL_PASSWORD=your-email-password\r\n```\r\n\r\n### 5. Initialize Database\r\n```bash\r\npython -c \"from models import init_db; init_db()\"\r\n```\r\n\r\n### 6. Run the Application\r\n```bash\r\npython app.py\r\n```\r\n\r\nThe application will be available at `http://localhost:5000`\r\n\r\n## 📊 Usage\r\n\r\n### Main Website\r\n- Visit `http://localhost:5000` for the main website\r\n- Use the chat widget in the bottom-right corner to start conversations\r\n- Fill out contact forms to generate leads\r\n\r\n### Admin Dashboard\r\n- Visit `http://localhost:5000/admin/dashboard` for the admin interface\r\n- Manage leads, view analytics, and create email campaigns\r\n- Monitor real-time chat activity and system performance\r\n\r\n### API Endpoints\r\nThe system provides comprehensive REST API endpoints:\r\n\r\n#### Lead Management\r\n- `GET /api/leads` - Get all leads\r\n- `POST /api/leads` - Create new lead\r\n- `PUT /api/leads/\u003cid\u003e` - Update lead\r\n- `DELETE /api/leads/\u003cid\u003e` - Delete lead\r\n\r\n#### Chat System\r\n- `POST /api/chat/start` - Start new conversation\r\n- `POST /api/chat/message` - Send message\r\n- `GET /api/chat/history` - Get chat history\r\n\r\n#### Analytics\r\n- `GET /api/analytics` - Get analytics data\r\n- `GET /api/dashboard/stats` - Get dashboard statistics\r\n\r\n#### Email Campaigns\r\n- `GET /api/campaigns` - Get all campaigns\r\n- `POST /api/campaigns` - Create new campaign\r\n- `PUT /api/campaigns/\u003cid\u003e` - Update campaign\r\n\r\n## 🎯 Key Features Detail\r\n\r\n### AI-Powered Chatbot\r\n- Intent recognition and response generation\r\n- Context-aware conversations\r\n- Product recommendations based on user needs\r\n- Fallback handling for complex queries\r\n\r\n### Lead Scoring System\r\n- Automatic lead scoring based on multiple factors\r\n- Lead qualification and prioritization\r\n- Engagement tracking and analytics\r\n\r\n### Email Automation\r\n- Automated welcome sequences\r\n- Nurture campaigns based on lead behavior\r\n- Personalized product recommendations\r\n- A/B testing capabilities\r\n\r\n### Analytics Dashboard\r\n- Real-time performance metrics\r\n- Lead generation trends\r\n- Conversion funnel analysis\r\n- Email campaign performance\r\n\r\n## 🔒 Security Features\r\n\r\n- Input validation and sanitization\r\n- SQL injection prevention\r\n- Cross-site scripting (XSS) protection\r\n- CORS configuration\r\n- Rate limiting (configurable)\r\n\r\n## 📈 Performance Optimization\r\n\r\n- Database indexing for faster queries\r\n- Caching for frequently accessed data\r\n- Optimized API responses\r\n- Efficient WebSocket handling\r\n- Static file optimization\r\n\r\n## 🧪 Testing\r\n\r\n### Running Tests\r\n```bash\r\npython -m pytest tests/\r\n```\r\n\r\n### Test Coverage\r\n- Unit tests for all services\r\n- Integration tests for API endpoints\r\n- Frontend functionality tests\r\n\r\n## 📚 API Documentation\r\n\r\n### Authentication\r\nCurrently, the system uses session-based authentication. API keys can be implemented for programmatic access.\r\n\r\n### Response Format\r\nAll API responses follow this format:\r\n```json\r\n{\r\n  \"success\": true,\r\n  \"data\": {...},\r\n  \"message\": \"Success message\",\r\n  \"timestamp\": \"2025-01-13T10:30:00Z\"\r\n}\r\n```\r\n\r\n### Error Handling\r\nErrors are returned with appropriate HTTP status codes:\r\n```json\r\n{\r\n  \"success\": false,\r\n  \"error\": \"Error message\",\r\n  \"code\": \"ERROR_CODE\",\r\n  \"timestamp\": \"2025-01-13T10:30:00Z\"\r\n}\r\n```\r\n\r\n## 🔄 Deployment\r\n\r\n### Production Deployment\r\n1. Set up production environment variables\r\n2. Configure production database (PostgreSQL recommended)\r\n3. Set up email service (SendGrid, AWS SES, etc.)\r\n4. Configure web server (Nginx + Gunicorn)\r\n5. Set up SSL certificates\r\n6. Configure monitoring and logging\r\n\r\n### Docker Deployment\r\n```bash\r\n# Build the image\r\ndocker build -t zehrasec-app .\r\n\r\n# Run the container\r\ndocker run -p 5000:5000 zehrasec-app\r\n```\r\n\r\n## 📝 Configuration\r\n\r\n### Environment Variables\r\n- `SECRET_KEY`: Flask secret key\r\n- `OPENAI_API_KEY`: OpenAI API key for AI features\r\n- `DATABASE_URL`: Database connection string\r\n- `EMAIL_HOST`: SMTP server host\r\n- `EMAIL_PORT`: SMTP server port\r\n- `EMAIL_USER`: Email username\r\n- `EMAIL_PASSWORD`: Email password\r\n\r\n### Application Settings\r\nConfigure in `config.py`:\r\n- Database settings\r\n- Email settings\r\n- AI service settings\r\n- Product information\r\n- Company information\r\n\r\n## 🤝 Contributing\r\n\r\n1. Fork the repository\r\n2. Create a feature branch\r\n3. Make your changes\r\n4. Write tests for new functionality\r\n5. Submit a pull request\r\n\r\n## 📄 License\r\n\r\nThis project is licensed under the MIT License - see the LICENSE file for details.\r\n\r\n## 💡 Future Enhancements\r\n\r\n- [ ] User authentication and role-based access\r\n- [ ] Advanced analytics and reporting\r\n- [ ] Integration with popular CRM systems\r\n- [ ] Mobile app for iOS and Android\r\n- [ ] Advanced AI features (sentiment analysis, etc.)\r\n- [ ] Multi-language support\r\n- [ ] Advanced email templates\r\n- [ ] Integration with social media platforms\r\n- [ ] Video chat capabilities\r\n- [ ] Advanced security features\r\n\r\n## 🆘 Support\r\n\r\nFor support and questions:\r\n- Email: support@zehrasec.com\r\n- Documentation: [Link to documentation]\r\n- Issues: [GitHub Issues](https://github.com/username/zehrasec/issues)\r\n\r\n## 🙏 Acknowledgments\r\n\r\n- OpenAI for AI capabilities\r\n- Flask community for the excellent framework\r\n- Bootstrap for UI components\r\n- All contributors and testers\r\n\r\n---\r\n\r\n**ZehraSec AI-Powered Client Acquisition System** - Building the future of cybersecurity sales and engagement.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyashab-cyber%2Fzeo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyashab-cyber%2Fzeo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyashab-cyber%2Fzeo/lists"}