{"id":32543987,"url":"https://github.com/ka-tasin/convo.ai","last_synced_at":"2026-04-10T11:32:04.400Z","repository":{"id":317647933,"uuid":"1067902174","full_name":"ka-tasin/convo.ai","owner":"ka-tasin","description":"Convo.AI is a full-stack real-time chat application that enables seamless communication between users and an integrated AI assistant. ","archived":false,"fork":false,"pushed_at":"2025-10-28T05:59:22.000Z","size":1104,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-28T07:15:28.070Z","etag":null,"topics":["express-js","mongoose","node-js","reactjs","socket-io","typescript"],"latest_commit_sha":null,"homepage":"https://convo-ai-xi.vercel.app","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/ka-tasin.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-01T14:54:21.000Z","updated_at":"2025-10-28T05:59:25.000Z","dependencies_parsed_at":"2025-10-02T07:19:45.836Z","dependency_job_id":"55799b85-c131-481e-aa13-71e653cfd718","html_url":"https://github.com/ka-tasin/convo.ai","commit_stats":null,"previous_names":["ka-tasin/convo.ai"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ka-tasin/convo.ai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ka-tasin%2Fconvo.ai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ka-tasin%2Fconvo.ai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ka-tasin%2Fconvo.ai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ka-tasin%2Fconvo.ai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ka-tasin","download_url":"https://codeload.github.com/ka-tasin/convo.ai/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ka-tasin%2Fconvo.ai/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31641114,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-10T07:40:12.752Z","status":"ssl_error","status_checked_at":"2026-04-10T07:40:11.664Z","response_time":98,"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":["express-js","mongoose","node-js","reactjs","socket-io","typescript"],"created_at":"2025-10-28T17:01:59.609Z","updated_at":"2026-04-10T11:32:04.395Z","avatar_url":"https://github.com/ka-tasin.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Convo.AI\n\n**Convo.AI** is a full-stack real-time chat application that enables seamless communication between users and an integrated AI assistant.  \nIt’s built with an architecture focusing on scalability, clean backend structure, and efficient real-time data flow using Socket.io.  \nThe backend is implemented with **Node.js**, **TypeScript**, **Socket.io**, **Express**, **MongoDB (Mongoose)**, and **JWT** for secure authentication.\n\n---\n\n### **AI Conversation Integration via `@ai`**\n\n- Convo.AI allows users to **instantly involve ChatGPT in any ongoing conversation**.  \n- To summon the AI, simply type **`@ai`** in your message\n- The system will automatically **detect the tag**, **forward the conversation to OpenAI’s API**, and **stream back the AI-generated response** in real time.\n\nThis feature bridges **human-to-human** and **human-to-AI** communication seamlessly inside a single chat room.\n\n##  Features\n\n### Backend\n- RESTful API built with **Express + TypeScript**\n- **JWT-based authentication** for secure user sessions\n- **Socket.io** for real-time chat communication\n- **Mongoose** for MongoDB ODM\n- **Layered architecture** (Controller → Service → Repository)\n- Environment-based configuration via `.env`\n\n### Frontend\n- Built with **React.js**\n- Integrated **Socket.io-client** for live messaging\n- Real-time updates and AI-generated responses\n- Authentication via tokens from backend\n\n---\n\n## Tech Stack\n\n**Backend**\n- Node.js  \n- Express.js  \n- TypeScript  \n- MongoDB + Mongoose  \n- Socket.io  \n- JSON Web Token (JWT)  \n\n\n**Frontend**\n- React.js  \n- Socket.io-client  \n- Tailwind CSS  \n\n---\n\n\n\n## Environment Variables\n\nCreate a `.env` file in the `server` folder with the following variables:\n```\nPORT=3000\nMONGODB_URI=your_mongodb_connection_string\nJWT_SECRET=your_jwt_secret_key\nCLIENT_URL=http://localhost:5173\nPORT=5000\nOPENAI_API_KEY=sk-***********\nPORTFOLIO_MODE=false\n```\n\n---\n\n##  Setup Instructions\n\n### 1. Clone the Repository\n```bash\ngit clone https://github.com/your-username/convo.ai.git\ncd convo.ai\n```\n### 2. Backend Setup (Server)\n```bash\ncd server\nnpm install\n```\n\n### Run in Development\n```bash\nnpm run dev\n```\n\n***Backend should be running at: http://localhost:3000***\n\n### 3. Frontend Setup (Client)\n```bash\ncd ../client\nnpm install\n```\n\n- Run Frontend\n```\nnpm run dev\n```\n\n***Frontend should be running at: http://localhost:5173***\n\n## API Overview\nMethod\tEndpoint\tDescription\tAuth\n\n```\nPOST\t/api/auth/register\tRegister a new user\t\nPOST\t/api/auth/login\tLogin and get JWT token\t\nGET\t/api/users/:id\tGet user details\t\nGET\t/api/messages\tGet chat messages\t\nPOST\t/api/messages\tSend a message\n```\n\n- Requires valid JWT token in Authorization header\nExample: Authorization: Bearer \u003ctoken\u003e\n\n## Architecture Overview\n\n- Controller Layer: Handles incoming HTTP requests.\n- Service Layer: Contains business logic.\n- Repository Layer: Handles database queries via Mongoose.\n- Socket Layer: Manages real-time message delivery.\n- Middleware: Authenticates JWT tokens and handles errors globally.\n\n\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fka-tasin%2Fconvo.ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fka-tasin%2Fconvo.ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fka-tasin%2Fconvo.ai/lists"}