{"id":30232400,"url":"https://github.com/dhenenjay/ai-superconnector","last_synced_at":"2026-05-05T19:32:53.562Z","repository":{"id":309940170,"uuid":"1038115632","full_name":"Dhenenjay/ai-superconnector","owner":"Dhenenjay","description":"AI-powered Twilio + OpenAI integration for WhatsApp and Voice calls","archived":false,"fork":false,"pushed_at":"2025-08-14T18:25:09.000Z","size":206,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-14T18:32:18.004Z","etag":null,"topics":["fastapi","openai","twilio","voice-ai","websocket","whatsapp"],"latest_commit_sha":null,"homepage":"https://github.com/Dhenenjay/ai-superconnector","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/Dhenenjay.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-08-14T16:38:41.000Z","updated_at":"2025-08-14T18:25:12.000Z","dependencies_parsed_at":"2025-08-14T18:32:19.687Z","dependency_job_id":"c97330b0-8cec-4612-9306-506d41d5ea4a","html_url":"https://github.com/Dhenenjay/ai-superconnector","commit_stats":null,"previous_names":["dhenenjay/ai-superconnector"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Dhenenjay/ai-superconnector","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dhenenjay%2Fai-superconnector","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dhenenjay%2Fai-superconnector/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dhenenjay%2Fai-superconnector/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dhenenjay%2Fai-superconnector/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Dhenenjay","download_url":"https://codeload.github.com/Dhenenjay/ai-superconnector/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dhenenjay%2Fai-superconnector/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278956328,"owners_count":26075221,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["fastapi","openai","twilio","voice-ai","websocket","whatsapp"],"created_at":"2025-08-15T00:00:38.312Z","updated_at":"2025-10-08T13:57:51.460Z","avatar_url":"https://github.com/Dhenenjay.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 AI Superconnector - Twilio + OpenAI Realtime Integration\n\n[![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy?repo=https://github.com/Dhenenjay/ai-superconnector)\n\n## 📋 Overview\n\nAI Superconnector is a FastAPI backend service that bridges:\n- **Twilio**: WhatsApp messaging and Voice calls with bidirectional audio streaming\n- **OpenAI**: Realtime API for voice conversations and AI-powered responses\n- **Convex DB**: Cloud database for conversation history and user management\n\nGetting started (Windows PowerShell)\n1) Create and activate a virtual environment\n   - Using the provided script:\n     - powershell: scripts/setup.ps1\n   - Or manually:\n     - python -m venv .venv\n     - .\\.venv\\Scripts\\Activate.ps1\n     - python -m pip install --upgrade pip\n     - pip install -r requirements.txt\n\n2) Configure environment\n   - Copy .env.example to .env and set values.\n   - Optional: set OPENAI_API_KEY for real embeddings.\n\n3) Initialize the database (auto on first run)\n   - The app will create SQLite DB at ./.data/dev.db\n\n4) Run the API\n   - uvicorn apps.api.main:app --reload --port 8000\n\n5) Open the docs\n   - http://127.0.0.1:8000/docs\n\nProject layout\n- apps/api: FastAPI app and routers\n- core: config, DB, models, schemas\n- services/connectors: connector stubs\n- services/ai: retrieval and tools stubs\n- scripts: helper scripts for setup\n\nNext steps\n- Wire real OAuth for Gmail/Slack/Notion\n- Replace hashing embeddings with OpenAI or another provider\n- Add background jobs (APScheduler or external queue if/when you add Redis)\n- Implement webhooks for incremental updates\n- Build a web dashboard (Next.js) or keep using Swagger for now\n\n## 🌟 Features\n\n- ✅ **WhatsApp Integration**: Send/receive messages via Twilio\n- ✅ **Voice Calls**: Bidirectional audio streaming with OpenAI Realtime API\n- ✅ **WebSocket Bridge**: Real-time communication between Twilio and OpenAI\n- ✅ **AI Embeddings**: Semantic search with OpenAI embeddings\n- ✅ **User Management**: Complete user CRUD operations\n- ✅ **Conversation History**: Store and retrieve chat/call history\n\n## 🚀 Quick Deploy\n\n### Deploy to Render (Recommended)\n1. Click the Deploy button above\n2. Set environment variables in Render dashboard\n3. Your API will be live at `https://your-app.onrender.com`\n\n### Deploy to Railway\n```bash\nrailway login\nrailway init\nrailway up\n```\n\n## 🔑 Environment Variables\n\nCreate a `.env` file based on `.env.example`:\n\n```env\n# OpenAI\nOPENAI_API_KEY=sk-proj-...\nOPENAI_REALTIME_MODEL=gpt-4o-realtime-preview-2024-12-17\n\n# Twilio\nTWILIO_ACCOUNT_SID=AC...\nTWILIO_AUTH_TOKEN=your-auth-token\nTWILIO_API_KEY=SK...\nTWILIO_API_SECRET=your-api-secret\nTWILIO_PHONE_NUMBER=+1234567890\n\n# Convex DB (optional)\nCONVEX_URL=https://your-instance.convex.cloud\n```\n\n## 📱 Twilio Setup\n\n1. **Configure Webhooks** in Twilio Console:\n   - WhatsApp: `https://your-api.com/twilio/webhook/whatsapp`\n   - Voice: `https://your-api.com/twilio/webhook/voice/outbound`\n\n2. **Enable Media Streams** for bidirectional audio\n\n## 📖 API Documentation\n\n- Swagger UI: `http://localhost:8000/docs`\n- ReDoc: `http://localhost:8000/redoc`\n\n## 🛠️ Development\n\n```bash\n# Install dependencies\npip install -r requirements.txt\n\n# Run with hot reload\nuvicorn apps.api.main:app --reload --port 8000\n\n# Run tests\npytest tests/\n```\n\n## 📝 License\n\nMIT License - feel free to use this for your projects!\n\n## 🤝 Contributing\n\nContributions welcome! Please open an issue or PR.\n\n## ⚠️ Security Notes\n\n- Never commit `.env` files or API keys\n- Use environment variables in production\n- Enable HTTPS for all production deployments\n- Implement rate limiting for public APIs\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdhenenjay%2Fai-superconnector","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdhenenjay%2Fai-superconnector","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdhenenjay%2Fai-superconnector/lists"}