{"id":21538138,"url":"https://github.com/gabrielelanzafamee/assistly","last_synced_at":"2026-04-27T16:33:51.350Z","repository":{"id":272443309,"uuid":"888503600","full_name":"gabrielelanzafamee/assistly","owner":"gabrielelanzafamee","description":"Modern customer service platform combining AI capabilities with multi-channel communication. Built with NestJS, Angular, OpenAI, and Twilio.","archived":false,"fork":false,"pushed_at":"2025-01-14T12:40:13.000Z","size":508,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-31T00:51:28.926Z","etag":null,"topics":["ai","angular","assistant-chat-bots","deepgram","elevenlabs","nestjs","openai","twilio","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/gabrielelanzafamee.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":"FUNDING.yml","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},"funding":{"github":["gabrielelanzafamee"]}},"created_at":"2024-11-14T14:10:07.000Z","updated_at":"2025-01-17T16:26:56.000Z","dependencies_parsed_at":"2025-01-14T13:54:06.011Z","dependency_job_id":"72752807-8caf-4ebe-bff0-57231522f988","html_url":"https://github.com/gabrielelanzafamee/assistly","commit_stats":null,"previous_names":["gabrielelanzafamee/assistly"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/gabrielelanzafamee/assistly","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabrielelanzafamee%2Fassistly","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabrielelanzafamee%2Fassistly/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabrielelanzafamee%2Fassistly/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabrielelanzafamee%2Fassistly/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gabrielelanzafamee","download_url":"https://codeload.github.com/gabrielelanzafamee/assistly/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabrielelanzafamee%2Fassistly/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32345806,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T23:26:28.701Z","status":"online","status_checked_at":"2026-04-27T02:00:06.769Z","response_time":128,"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":["ai","angular","assistant-chat-bots","deepgram","elevenlabs","nestjs","openai","twilio","typescript"],"created_at":"2024-11-24T04:10:44.943Z","updated_at":"2026-04-27T16:33:51.333Z","avatar_url":"https://github.com/gabrielelanzafamee.png","language":"TypeScript","funding_links":["https://github.com/sponsors/gabrielelanzafamee"],"categories":[],"sub_categories":[],"readme":"# Assistly\n\nA modern, scalable customer service platform built with NestJS and Angular, featuring AI-powered interactions, customer management, and multi-channel communication capabilities.\n\n## Features\n\n- AI-powered customer interactions\n- Comprehensive customer management\n- Multi-channel communication (Email, SMS, WhatsApp)\n- Real-time updates with WebSocket\n- Customer analytics and insights\n- Role-based access control\n- Multi-organization support\n- Custom tools integration\n- Voice call support\n- WhatsApp integration\n- SMS capabilities\n- Knowledge base management\n- Automatic responses\n- Analytics dashboard\n\n## Prerequisites\n\nBefore you begin, ensure you have the following installed:\n- Node.js (v18 or higher)\n- MongoDB (v4.4 or higher)\n- npm or yarn\n- Angular CLI (npm install -g @angular/cli)\n\n## Getting Started\n\n1. Clone the repository:\n- `git clone https://github.com/gabrielelanzafamee/assistly.git`\n- `cd assistly`\n\n2. Environment Setup\nCreate .env file in the root directory with the following variables:\n\n```\n# Database\nMONGODB_URI=mongodb://localhost:27017/your-database\n\n# JWT\nJWT_SECRET=your-secret-key\nJWT_EXPIRATION=30d\n\n# OpenAI\nOPENAI_API_KEY=your-openai-api-key\nOPENAI_ORGANIZATION=your-openai-organization\n\n# Twilio\nTWILIO_ACCOUNT_SID=your-twilio-sid\nTWILIO_AUTH_TOKEN=your-twilio-token\nTWILIO_PHONE_NUMBER=your-twilio-phone\n\n# ElevenLabs (Optional - for voice synthesis)\nELEVEN_LABS_API_KEY=your-eleven-labs-key\n\n# Deepgram (Optional - for real-time speech recognition)\nDEEPGRAM_API_KEY=your-eleven-labs-key\n\n# System\nPORT=3000\nBASE_URL=http://localhost:3000\nNODE_ENV=development\n```\n\n3. Install Dependencies\n\nFor the backend:\n- `npm install`\n\nFor the frontend:\n- `cd public`\n- `npm install`\n\n4. Run the Application\n\nStart the backend server:\n- `npm run start:dev`\n\nStart the frontend application:\n- `cd public`\n- `npm run start`\n\nThe application will be available at:\n- Frontend: http://localhost:4200\n- Backend API: http://localhost:5000\n- API Documentation: http://localhost:5000/api/v1\n\n## Project Structure\n```\nsrc/                  # Backend source code (NestJS)\n├── core/            # Core functionality\n│   ├── config/      # Configuration\n│   ├── decorators/  # Custom decorators\n│   ├── guards/      # Auth guards\n│   └── interfaces/  # TypeScript interfaces\n├── customers/       # Customer management\n├── messages/        # Messaging system\n├── calls/           # Call handling\n├── openai/          # AI integration\n└── websockets/      # Real-time communication\npublic/              # Frontend source code (Angular)\n├── src/\n│   ├── modules/     # Feature modules\n│   ├── shared/      # Shared components\n│   └── core/        # Core services\n```\n\n## Configuration\n\n1. OpenAI Setup\n- Create an account at OpenAI (https://openai.com)\n- Get your API key from the dashboard\n- Add it to your .env file\n\n2. Twilio Setup\n- Create an account at Twilio (https://www.twilio.com)\n- Get your Account SID and Auth Token\n- Purchase a phone number\n- Add credentials to your .env file\n\n3. ElevenLabs Setup (Optional)\n- Create an account at ElevenLabs (https://elevenlabs.io)\n- Get your API key\n- Add it to your .env file\n\n4. Deepgram Setup (Optional)\n- Create an account at Deepgram (https://deepgram.com)\n- Get your API key\n- Add it to your .env file\n\n## Contributing\n\nWe welcome contributions! Here's how you can help:\n\n1. Fork the repository\n2. Create your feature branch (git checkout -b feature/AmazingFeature)\n3. Commit your changes (git commit -m 'Add some AmazingFeature')\n4. Push to the branch (git push origin feature/AmazingFeature)\n5. Open a Pull Request\n\nPlease ensure your PR adheres to our coding standards and includes appropriate tests.\n\n## Running Tests\n\nBackend tests:\n- `npm run test`\n- `npm run test:e2e`\n\nFrontend tests:\n- `cd public`\n- `ng test`\n\n## API Documentation\n\nAPI documentation is automatically generated using Swagger and is available at http://localhost:5000/api/v1 when running the development server.\n\n## Security Features\n\n- JWT authentication\n- Role-based access control\n- Organization-level data isolation\n- Input validation\n- Rate limiting\n- CORS protection\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Support\n\nIf you find this project useful, please give it a star on GitHub!\n\nFor questions and support:\n- Open an issue\n\n## Acknowledgments\n\n- NestJS (https://nestjs.com/) - The backend framework\n- Angular (https://angular.io/) - The frontend framework\n- OpenAI (https://openai.com/) - AI capabilities\n- Twilio (https://www.twilio.com/) - Communication services\n- ElevenLabs (https://elevenlabs.io/) - Voice synthesis\n- MongoDB (https://www.mongodb.com/) - Database\n- All our amazing contributors!\n\n## Additional Resources\n\n- NestJS Documentation: https://docs.nestjs.com/\n- Angular Documentation: https://angular.io/docs\n- OpenAI API Documentation: https://platform.openai.com/docs/\n- Twilio Documentation: https://www.twilio.com/docs\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgabrielelanzafamee%2Fassistly","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgabrielelanzafamee%2Fassistly","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgabrielelanzafamee%2Fassistly/lists"}