{"id":25983873,"url":"https://github.com/sccsmartcode/verisbot","last_synced_at":"2026-05-17T19:38:25.230Z","repository":{"id":279081452,"uuid":"937660215","full_name":"SCCSMARTCODE/VerisBot","owner":"SCCSMARTCODE","description":"VerisBot is a production-grade enterprise AI chatbot built with FastAPI and powered by the Hugging Face Inference API. Leveraging the google/gemma-2-2b-it model, VerisBot delivers clear, accurate, and instruction-following responses tailored for enterprise use","archived":false,"fork":false,"pushed_at":"2025-02-23T18:36:32.000Z","size":26,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-26T22:38:15.460Z","etag":null,"topics":["ai","chatbot","fastapi","huggingface","llm","nlp","serverless"],"latest_commit_sha":null,"homepage":"https://veris-bot.vercel.app","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/SCCSMARTCODE.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-02-23T15:56:12.000Z","updated_at":"2025-02-24T13:05:41.000Z","dependencies_parsed_at":"2025-02-23T17:25:56.214Z","dependency_job_id":"d2f0251d-62f5-4fdc-ac6e-5cc0a9d0d07c","html_url":"https://github.com/SCCSMARTCODE/VerisBot","commit_stats":null,"previous_names":["sccsmartcode/verisbot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/SCCSMARTCODE/VerisBot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SCCSMARTCODE%2FVerisBot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SCCSMARTCODE%2FVerisBot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SCCSMARTCODE%2FVerisBot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SCCSMARTCODE%2FVerisBot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SCCSMARTCODE","download_url":"https://codeload.github.com/SCCSMARTCODE/VerisBot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SCCSMARTCODE%2FVerisBot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33152157,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-17T09:28:26.183Z","status":"ssl_error","status_checked_at":"2026-05-17T09:27:52.702Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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","chatbot","fastapi","huggingface","llm","nlp","serverless"],"created_at":"2025-03-05T10:33:34.534Z","updated_at":"2026-05-17T19:38:25.205Z","avatar_url":"https://github.com/SCCSMARTCODE.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VerisBot\n\n**VerisBot** is a fun and experimental AI chatbot developed as a learning adventure using FastAPI and the Hugging Face Inference API. Powered by the google/gemma-2-2b-it model, this project showcases the art of crafting conversational AI, aimed at exploring how to create engaging, accurate, and intelligent responses. While it’s not designed for production use, VerisBot serves as an exciting playground for me to dive into the world of AI, master new technologies, and unleash creativity in developing advanced chat solutions.\n\n\n## Table of Contents\n\n- [Features](#features)\n- [Architecture](#architecture)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Deployment](#deployment)\n- [Configuration](#configuration)\n- [Contributing](#contributing)\n- [License](#license)\n- [Contact](#contact)\n\n## Features\n\n- **Enterprise-Grade Chatbot:**  \n  Provides clear, accurate, and professional responses tailored to business needs.\n  \n- **Serverless and Scalable:**  \n  Leverages the Hugging Face Inference API to ensure cost-effective, scalable performance.\n  \n- **FastAPI-Based Backend:**  \n  A lightweight and responsive RESTful API for handling chat interactions.\n  \n- **Structured Response Formatting:**  \n  Utilizes a dedicated formatter to ensure all responses are well-structured and ready for frontend display.\n  \n- **Robust Prompt Engineering:**  \n  Includes strict system instructions to guide the model’s behavior and maintain consistency in tone and style.\n\n## Architecture\n\nVerisBot is built using a modular architecture:\n\n- **FastAPI Backend:**  \n  Handles incoming chat requests, manages sessions, and processes errors.\n  \n- **Hugging Face Inference API Integration:**  \n  Directly calls the `google/gemma-2-2b-it` model for generating responses.\n  \n- **Response Formatter:**  \n  Processes and formats generated text to ensure professional and consistent output on the frontend.\n  \n- **Environment Configuration:**  \n  All sensitive information (e.g., API keys) is managed through environment variables for security and flexibility.\n\n## Installation\n\n1. **Clone the Repository:**\n\n   ```bash\n   git clone https://github.com/SCCSMARTCODE/VerisBot.git\n   cd VerisBot\n   ```\n\n2. **Create a Virtual Environment and Install Dependencies:**\n\n   ```bash\n   python -m venv venv\n   source venv/bin/activate  # On Windows: venv\\Scripts\\activate\n   pip install -r requirements.txt\n   ```\n\n3. **Set Up Environment Variables:**\n\n   Create a `.env` file based on the provided `.env.example` and add your Hugging Face API key:\n\n   ```env\n   HF_API_KEY=your_huggingface_api_key\n   HF_API_URL=\"https://api-inference.huggingface.co/models/google/gemma-2-2b-it\"\n   ```\n\n## Usage\n\n1. **Run the FastAPI Server:**\n\n   ```bash\n   uvicorn app.main:app --reload\n   ```\n\n2. **Interact with the Chatbot:**\n\n   Send a POST request to the `/chat` endpoint with a JSON body containing a `message` field. For example:\n\n   ```json\n   {\n     \"user_id\": \"userId\",\n     \"message\": \"What is a noun?\"\n   }\n   ```\n\n   The server will return a response similar to:\n\n   ```json\n   {\n     \"veris_response\": \"I am Veris, a high-quality AI chatbot built by SCCSMARTCODE using the Hugging Face Inference API. [Detailed answer...]\"\n   }\n   ```\n\n## Contributing\n\nContributions are welcome! To contribute:\n\n1. Fork the repository.\n2. Create a new branch for your feature or bug fix.\n3. Include tests for your changes.\n4. Submit a pull request with a clear description of your changes.\n\nFor major changes, please open an issue first to discuss your ideas.\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n## Contact\n\nFor questions or support, please contact:  \n**SCCSMARTCODE**  \nEmail: [sccsmart247@gmail.com](mailto:sccsmart247@gmail.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsccsmartcode%2Fverisbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsccsmartcode%2Fverisbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsccsmartcode%2Fverisbot/lists"}