{"id":19092691,"url":"https://github.com/chloelavrat/personal-assistant","last_synced_at":"2026-05-16T00:08:11.535Z","repository":{"id":253231133,"uuid":"646821650","full_name":"chloelavrat/Personal-Assistant","owner":"chloelavrat","description":"Access different personal assistants with HuggingChat and Streamlit","archived":false,"fork":false,"pushed_at":"2024-08-01T21:31:47.000Z","size":3929,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-22T07:44:20.857Z","etag":null,"topics":["assistant-chat-bots","huggingchat","llm","llm-agent","llm-inference","streamlit","summary"],"latest_commit_sha":null,"homepage":"","language":"Python","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/chloelavrat.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":"2023-05-29T12:19:13.000Z","updated_at":"2024-08-15T08:51:05.000Z","dependencies_parsed_at":"2024-08-15T11:42:10.218Z","dependency_job_id":null,"html_url":"https://github.com/chloelavrat/Personal-Assistant","commit_stats":null,"previous_names":["chloelavrat/personal-assistant"],"tags_count":0,"template":false,"template_full_name":"streamlit/app-starter-kit","purl":"pkg:github/chloelavrat/Personal-Assistant","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chloelavrat%2FPersonal-Assistant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chloelavrat%2FPersonal-Assistant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chloelavrat%2FPersonal-Assistant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chloelavrat%2FPersonal-Assistant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chloelavrat","download_url":"https://codeload.github.com/chloelavrat/Personal-Assistant/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chloelavrat%2FPersonal-Assistant/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33085125,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-15T20:25:35.270Z","status":"ssl_error","status_checked_at":"2026-05-15T20:25:34.732Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":["assistant-chat-bots","huggingchat","llm","llm-agent","llm-inference","streamlit","summary"],"created_at":"2024-11-09T03:21:24.032Z","updated_at":"2026-05-16T00:08:11.519Z","avatar_url":"https://github.com/chloelavrat.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./assets/README_banner.png\" alt=\"Banner\" style=\"border-radius: 17px; width: 100%; max-width: 800px; height: auto;\"\u003e\n\u003c/div\u003e\n\n\u003ch3 align=\"center\"\u003e\n  \u003cb\u003e\u003ca href=\"https://azerty-labs.com\"\u003eOnline App\u003c/a\u003e\u003c/b\u003e\n  •\n  \u003cb\u003e\u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e\u003c/b\u003e\n  •\n  \u003cb\u003e\u003ca href=\"\"\u003eDemo Screenshot\u003c/a\u003e\u003c/b\u003e\n\u003c/h3\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://opensource.org/licenses/MIT\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/License-MIT-blue.svg\" alt=\"License\"\u003e\n  \u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/python-3.7+-blue.svg\" alt=\"Python Versions\"\u003e\n\u003c/div\u003e\n\u003c/br\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cb\u003ePersonal Assistant\u003c/b\u003e is a \u003ca href=\"https://streamlit.io/\"\u003eStreamlit\u003c/a\u003e application that allows users to interact with HugChat, providing an intuitive interface for engaging with AI-driven chatbot models. It supports custom assistants tailored to specific user needs and features secure user authentication.\n\u003c/p\u003e\n\n## Features\n\n- **User Authentication**: Securely login using your email and password, with cookies stored locally for a seamless experience.\n- **Three Customizable Assistants**:\n  - **David - Sports Coach**: A personal sports coach dedicated to helping you achieve your fitness and athletic goals through tailored advice and encouragement.\n  - **Synthia - Eurorack Expert**: A Eurorack synthesizer specialist who guides you in exploring and mastering your modular synthesizer setups.\n  - **Carla - UI/UX Designer**: A UI/UX designer with expertise in HTML, React, and CSS, ready to help you improve web interfaces and user experiences through effective design and coding practices.\n- **Web Search Integration**: Enable or disable web search functionality to enhance the chatbot's responses.\n- **Session Management**: Maintains chat history within the session, allowing for a continuous conversation experience.\n- **Streamlined Interface**: A user-friendly chat interface that supports real-time interaction with the AI assistant.\n\n## Usage\n\nTo use the app, simply go to the online demo hosted by streamlit. Log in with your hugging face credentials and start interacting with the AI assistant.\n\n### Selecting an Assistant\n\n- Navigate to the sidebar and choose from one of the three available assistants:\n  - **David - Sports Coach**: Get personalized fitness advice and motivation.\n  - **Synthia - Eurorack Expert**: Explore and master your Eurorack synthesizer setup.\n  - **Carla - UI/UX Designer**: Improve your web design projects with expert UI/UX guidance.\n  \n- Enable the \"Allow web search\" option if you want the assistant to fetch real-time information from the web.\n- Click on \"Initialize assistant\" to start the chat.\n\n### Chatting with the Assistant\n\n- Type your queries in the chat input box.\n- The assistant will respond based on your selected preprompt settings and available options.\n- Your chat history is preserved throughout the session for easy reference.\n\n## Run app locally\n\nIf you want to run the Personal Assistant Streamlit app locally, multiple solutions are possible:\n\n1. **Run the app directly in a virtual environment**\n    \n    Clone the repository:\n    ```\n    git clone https://github.com/chloelavrat/Personal_Assistant.git\n    cd Personal_Assistant\n    ```\n    Create, activate, and install your environment:\n    ```\n    python -m venv .venv\n    source .venv/bin/activate\n    pip install -r requirements.txt\n    ```\n    Run the app using Streamlit:\n    ```\n    streamlit run streamlit_app.py\n    ```\n\n2. **Run the app using Docker**\n\n    Build the `personal-assistant` Docker container:\n    ```\n    docker build -t personal-assistant .\n    ````\n    Run the container at a specified port (e.g., 8501):\n    ```\n    docker run -p 8501:8501 personal-assistant\n    ```\n    Go to your web browser and access [localhost:8501](http://localhost:8501).\n\n## Contributing\n\nContributions to the project are welcome! If you encounter any issues or bugs, please open an issue on the GitHub repository. To contribute code, fork the repository, make your changes, and submit a pull request.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchloelavrat%2Fpersonal-assistant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchloelavrat%2Fpersonal-assistant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchloelavrat%2Fpersonal-assistant/lists"}