{"id":17487494,"url":"https://github.com/shahbazshaddy/conversai-fastapi","last_synced_at":"2025-09-02T13:43:44.385Z","repository":{"id":258344325,"uuid":"873771648","full_name":"ShahbazShaddy/ConversAI-FastAPI","owner":"ShahbazShaddy","description":"A lightweight and scalable chatbot leveraging Groq's NLP capabilities with a FastAPI backend and an interactive HTML/CSS/JavaScript frontend. Easily configurable, secure, and deployable to platforms like Heroku, AWS, or Docker.","archived":false,"fork":false,"pushed_at":"2024-10-24T18:37:35.000Z","size":710,"stargazers_count":3,"open_issues_count":4,"forks_count":25,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-10T16:52:25.204Z","etag":null,"topics":["ai","chatbot","coversational-bot","fastapi","generative-ai","groq-api","hacktoberfest","hacktoberfest2024","llama3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ShahbazShaddy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2024-10-16T17:32:37.000Z","updated_at":"2024-10-24T18:37:39.000Z","dependencies_parsed_at":"2025-04-10T16:41:30.983Z","dependency_job_id":"10b73eb8-bed3-4f93-918b-777f9e35cd2a","html_url":"https://github.com/ShahbazShaddy/ConversAI-FastAPI","commit_stats":null,"previous_names":["shahbazshaddy/conversai-fastapi"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ShahbazShaddy/ConversAI-FastAPI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ShahbazShaddy%2FConversAI-FastAPI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ShahbazShaddy%2FConversAI-FastAPI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ShahbazShaddy%2FConversAI-FastAPI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ShahbazShaddy%2FConversAI-FastAPI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ShahbazShaddy","download_url":"https://codeload.github.com/ShahbazShaddy/ConversAI-FastAPI/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ShahbazShaddy%2FConversAI-FastAPI/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273293830,"owners_count":25079892,"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-09-02T02:00:09.530Z","response_time":77,"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","chatbot","coversational-bot","fastapi","generative-ai","groq-api","hacktoberfest","hacktoberfest2024","llama3"],"created_at":"2024-10-19T03:04:46.403Z","updated_at":"2025-09-02T13:43:44.349Z","avatar_url":"https://github.com/ShahbazShaddy.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Wireframe](frontend/img/wirefram.png)\n\n# Groq Conversational Chatbot using FastAPI\n\n## Overview\nThis project is a lightweight and scalable conversational chatbot that utilizes **Groq** for natural language processing and **FastAPI** as the backend. The chatbot handles user queries and provides conversational responses with an interactive frontend built using HTML, CSS, and JavaScript. It is designed for seamless interaction and easy scalability, making it suitable for conversational use cases.\n\n## Key Features\n- **FastAPI Backend**: High-performance backend framework that enables fast development and scalability.\n- **Groq API Integration**: Delivers highly accurate and engaging conversational experiences using Groq's AI models.\n- **Interactive Frontend**: Simple and user-friendly interface developed with HTML, CSS, and JavaScript.\n- **Scalable Architecture**: Easily extendable for custom conversational features and use cases.\n- **Environment Configuration**: Secure management of API keys using environment variables.\n\n## Tech Stack\n- **Backend**: FastAPI, Python\n- **Frontend**: HTML, CSS, JavaScript\n- **AI/Chat API**: Groq API\n- **Deployment**: Ready for deployment on platforms like Heroku, AWS, or Docker.\n\n## Table of Contents\n1. [Getting Started](#getting-started)\n2. [File Structure](#file-structure)\n3. [How It Works](#how-it-works)\n4. [Future Enhancements](#future-enhancements)\n5. [Contributing](#contributing)\n6. [License](#license)\n\n## Getting Started\n\n### Prerequisites\nMake sure you have the following installed:\n- Python 3.8+\n- FastAPI\n- Pydantic\n- Groq API Key (you can get one from [Groq's website](https://groq.com))\n- Dotenv for managing environment variables\n\n### Setup\n\n1. Clone the repository:\n    ```bash\n    git clone https://github.com/yourusername/groq-chatbot-fastapi.git\n    cd groq-chatbot-fastapi\n    ```\n\n2. Install the dependencies:\n    ```bash\n    pip install -r requirements.txt\n    ```\n\n3. Set up your environment variables:\n   - Create a `.env` file inside the `app/` folder.\n   - Add your Groq API key:\n     ```bash\n     GROQ_API_KEY=your_groq_api_key_here\n     ```\n\n4. Run the application:\n    ```bash\n    uvicorn main:app --reload\n    ```\n\n5. Open your browser and navigate to `http://127.0.0.1:8000/` to interact with the chatbot.\n\n## How It Works\n1. **Frontend**: The user interacts with the web interface (HTML, CSS, JavaScript) by submitting a message.\n2. **Backend**: The message is sent to the FastAPI backend for processing.\n3. **Groq API**: The FastAPI backend sends the message to the Groq API, which processes it and returns a response.\n4. **Response**: The chatbot sends the response back to the front end, where the user can view the reply and continue the conversation.\n\n## Future Enhancements\n- **Persistent Chat History**: Store chat conversations in a database for future reference.\n- **Enhanced UI**: Improve the frontend design with additional styling and interactive elements.\n- **Customizable Models**: Users can select from multiple AI models for different conversational experiences.\n\n## Contributing\nContributions are welcome! You can fix this project and submit a pull request with any improvements or suggestions. Please follow the standard GitHub workflow for contributing.\n\n## License\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshahbazshaddy%2Fconversai-fastapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshahbazshaddy%2Fconversai-fastapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshahbazshaddy%2Fconversai-fastapi/lists"}