{"id":21205929,"url":"https://github.com/tiserge2/chat-sos","last_synced_at":"2026-04-16T11:31:09.665Z","repository":{"id":262080461,"uuid":"886164158","full_name":"tiserge2/chat-sos","owner":"tiserge2","description":"LLM chat bot application","archived":false,"fork":false,"pushed_at":"2024-11-10T16:29:08.000Z","size":539,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-14T23:11:23.098Z","etag":null,"topics":["flask","llm","rag","reactjs"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/tiserge2.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}},"created_at":"2024-11-10T11:26:56.000Z","updated_at":"2024-11-10T16:29:11.000Z","dependencies_parsed_at":"2025-01-21T15:39:56.541Z","dependency_job_id":null,"html_url":"https://github.com/tiserge2/chat-sos","commit_stats":null,"previous_names":["tiserge2/chat-sos"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tiserge2/chat-sos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiserge2%2Fchat-sos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiserge2%2Fchat-sos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiserge2%2Fchat-sos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiserge2%2Fchat-sos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tiserge2","download_url":"https://codeload.github.com/tiserge2/chat-sos/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiserge2%2Fchat-sos/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31883691,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T09:23:21.276Z","status":"ssl_error","status_checked_at":"2026-04-16T09:23:15.028Z","response_time":69,"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":["flask","llm","rag","reactjs"],"created_at":"2024-11-20T20:53:45.958Z","updated_at":"2026-04-16T11:31:09.648Z","avatar_url":"https://github.com/tiserge2.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ChatSOS\n\nChatSOS is an interactive chat application designed to configure and manage the behavior of a conversational assistant model. It provides an Admin Panel to easily adjust configuration parameters for the chatbot, such as model type, persona, temperature, and more. The application communicates with a backend server to save and retrieve configuration settings.\n\n![chat-sos.png](https://github.com/tiserge2/chat-sos/blob/main/img/chat-sos.png) \n\nThis project implements the Retrieval Augmented Generation (RAG) Architecture.\n\n![rag-system.png](https://github.com/tiserge2/chat-sos/blob/main/img/rag-system.png) \n\n## Features\n\n- **Chat Interface**: A user-friendly chat interface for real-time communication with the assistant.\n- **Admin Panel**: A dashboard to configure settings such as:\n  - Model selection (`gpt-3.5-turbo`, custom fine-tuned models)\n  - Persona customization (to define the assistant's tone and behavior)\n  - Temperature (to control response randomness)\n  - Maximum tokens (to limit the length of responses)\n  - Data handling options (use uploaded data for training)\n- **Configuration Persistence**: Changes made in the admin panel are saved and applied immediately by the backend.\n- **Toast Notifications**: Success and error notifications are displayed on applying the configuration changes.\n  \n## Getting Started\n\nFollow these instructions to set up and run the project on your local machine.\n\n### Prerequisites\n\nMake sure you have the following software installed:\n\n- [Node.js](https://nodejs.org/) (for running the React frontend)\n- [npm](https://www.npmjs.com/) (Node package manager)\n- [Python](https://www.python.org/) (for running the Flask backend)\n- [Flask](https://flask.palletsprojects.com/en/2.0.x/) (Python web framework)\n\n### Installing\n\n#### 1. Clone the repository:\n\n```bash\ngit clone https://github.com/your-username/ChatSOS.git\ncd ChatSOS\n```\n\n#### 2. Set up the Frontend (React)\n\n```bash\ncd frontend\nnpm install\nnpm run start\n```\n\nThis will start the React app on http://localhost:3000.\n\n#### 3. Set up the Backend (Flask)\n\nMake sure you have the required Python libraries installed. Create a virtual environment and install dependencies.\n\n```bash\nconda create --name chat-sos\nconda activate chatsos\npip install -r requirements.txt\n```\n\nThe Flask API will run on http://localhost:5000.\n\nConfiguration API Endpoints\n\n\t•\tGET /get_config: Fetches the current configuration of the assistant model.\n\t•\tPOST /update_config: Updates the assistant configuration settings.\n    •\tGET-POST /status: Check if the API is running.\n    •\tPOST /update_gpt_database: Updates the vector database with new data.\n    •\tPOST /ask_assistant: Queries the assistant with question.\n\n\nExample POST Request (from frontend)\n\nThe frontend sends a POST request to the backend to update the configuration:\n\n{\n  \"config\": {\n    \"selectedModel\": \"gpt-3.5-turbo\",\n    \"persona\": \"You are a helpful assistant.\",\n    \"temperature\": 0.01,\n    \"chatCompletionChoices\": 1,\n    \"maxTokens\": 15,\n    \"useUploadedData\": \"No\"\n  }\n}\n\n### Notes\n\n\t•\tThe backend stores the configuration in a simple format (e.g., a JSON object), and retrieves it on page load to update the form fields in the Admin Panel.\n\t•\tThe admin panel is a React-based interface that uses hooks and state management to handle user inputs and interact with the Flask API.\n\n### File Structure\n\n    chat-sos/\n    │\n    ├── frontend/                 # React application (Admin Panel and Chat Interface)\n    │   ├── src/\n    │   ├── public/\n    │   └── package.json          # NPM dependencies and scripts\n    │\n    └── backend/                  # Flask API (for handling configuration updates)\n        ├── app.py                # Main backend application\n        ├── requirements.txt      # Python dependencies\n        └── .env                  # Environement variables\n\n### Usage\n\n\t1.\tOpen the React app in your browser (http://localhost:3000/chat).\n\t2.\tUse the chat interface to interact with the assistant.\n\t3.\tUse the Admin Panel to modify settings such as model type and temperature.\n\t4.\tChanges in the Admin Panel are applied immediately, and you will receive a success or error notification.\n\n### Contributing\n\nFeel free to fork the repository, create a new branch, and make improvements. If you find bugs or want to add features, open an issue or submit a pull request.\n\n### License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftiserge2%2Fchat-sos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftiserge2%2Fchat-sos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftiserge2%2Fchat-sos/lists"}