{"id":25256951,"url":"https://github.com/thecarbun/perso9","last_synced_at":"2026-02-14T12:01:40.232Z","repository":{"id":260425421,"uuid":"881220274","full_name":"TheCarBun/Perso9","owner":"TheCarBun","description":"Fully customizable AI Characters","archived":false,"fork":false,"pushed_at":"2025-02-20T15:32:34.000Z","size":31,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-27T02:40:42.534Z","etag":null,"topics":["ai","artificial-intelligence","openai-api","opensource","personal-ai","streamlit","streamlit-webapp"],"latest_commit_sha":null,"homepage":"https://perso9.streamlit.app/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TheCarBun.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":"2024-10-31T06:07:20.000Z","updated_at":"2025-09-01T06:29:33.000Z","dependencies_parsed_at":null,"dependency_job_id":"c333ec10-1472-48cf-a791-1b445603c1b0","html_url":"https://github.com/TheCarBun/Perso9","commit_stats":null,"previous_names":["thecarbun/perso9"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/TheCarBun/Perso9","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheCarBun%2FPerso9","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheCarBun%2FPerso9/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheCarBun%2FPerso9/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheCarBun%2FPerso9/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheCarBun","download_url":"https://codeload.github.com/TheCarBun/Perso9/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheCarBun%2FPerso9/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29443468,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-14T10:51:12.367Z","status":"ssl_error","status_checked_at":"2026-02-14T10:50:52.088Z","response_time":53,"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":["ai","artificial-intelligence","openai-api","opensource","personal-ai","streamlit","streamlit-webapp"],"created_at":"2025-02-12T06:31:36.857Z","updated_at":"2026-02-14T12:01:40.216Z","avatar_url":"https://github.com/TheCarBun.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🦊 Perso9 - Create Your Personalized AI Chat Assistant!  \n![GitHub commit activity](https://img.shields.io/github/commit-activity/t/TheCarBun/Perso9?style=for-the-badge) \n![GitHub Issues or Pull Requests](https://img.shields.io/github/issues-raw/TheCarBun/Perso9?style=for-the-badge) \n![GitHub Issues or Pull Requests](https://img.shields.io/github/issues-pr-raw/TheCarBun/Perso9?style=for-the-badge) \n![GitHub Issues or Pull Requests](https://img.shields.io/github/issues-closed-raw/TheCarBun/Perso9?style=for-the-badge) \n![GitHub Issues or Pull Requests](https://img.shields.io/github/issues-pr-closed-raw/TheCarBun/Perso9?style=for-the-badge)\n![GitHub last commit](https://img.shields.io/github/last-commit/TheCarBun/Perso9?style=for-the-badge)\n![GitHub forks](https://img.shields.io/github/forks/TheCarBun/Perso9?style=for-the-badge)\n![GitHub Repo stars](https://img.shields.io/github/stars/TheCarBun/Perso9?style=for-the-badge)\n### 🦊 About\nPerso9 is designed to make conversational AI more personal and fun. Whether you're building an assistant or just chatting for fun, Perso9 adapts to your needs!\nPerso9 is a powerful and customizable AI chatbot built with **Streamlit** and **OpenAI**. With Perso9, users can define the personality, role, tone, and knowledge scope of their AI assistant and have meaningful conversations tailored to their preferences.\n\n\n![image](https://github.com/user-attachments/assets/94c478d8-17f4-40d4-b610-271da08db46e)\n\n\u003cdetails\u003e\n  \u003csummary\u003e📌 Table of Contents\u003c/summary\u003e\n  \n  - [Features](#-features)\n  - [Installation](#-installation)\n  - [How to Use](#-how-to-use)\n  - [Customization Options](#-customization-options)\n  - [Tech Stack](#-tech-stack)\n  - [Contributing](#-contributing)\n  - [License](#-license)\n\u003c/details\u003e\n\n---\n\n## ✨ Features\n- **Dynamic AI Personality**: Customize how your AI behaves, from tone of voice to knowledge scope.  \n- **Interactive Chat**: Intuitive chat interface that adapts to your custom AI definition.  \n- **Predefined or Custom Configurations**: Start with a friendly assistant or create your own unique AI.  \n- **Easy Deployment**: Deploy on **Streamlit Cloud** or run locally.  \n- **Responsive Design**: Styled with custom CSS for a clean and modern look.  \n\n---\n\n## 🛠 Installation\n### Prerequisites\n- Python 3.8 or later  \n- OpenAI API Key  \n\n### Steps\n1. Clone the repository:  \n   ```bash\n   git clone https://github.com/your-repo/perso9.git\n   cd perso9\n   ```\n\n2. Install dependencies:  \n   ```bash\n   pip install -r requirements.txt\n   ```\n\n3. Set up your OpenAI API key:  \n   Add the API key to a `.streamlit/secrets.toml` file:\n   ```toml\n   [secrets]\n   OPENAI_API_KEY = \"your_openai_api_key\"\n   ```\n\n4. Run the app:  \n   ```bash\n   streamlit run app.py\n   ```\n\n---\n\n## 🎮 How to Use\n1. Launch the app.  \n2. Use the **sidebar** to customize your AI assistant:  \n   - Define personality, tone, knowledge scope, and more.  \n3. Start chatting in the input field at the bottom of the screen.  \n4. Watch your AI respond dynamically based on your customization.  \n\n---\n\n## 🎨 Customization Options\n| Field                  | Description                                                                 |\n|------------------------|-----------------------------------------------------------------------------|\n| **AI Personality**     | Define the AI's personality (e.g., \"Curious philosopher\").                  |\n| **AI Role**            | Specify the AI's role (e.g., \"Technical advisor\").                         |\n| **Tone of Voice**      | Choose between Formal, Casual, Inspirational, or Technical.                |\n| **Knowledge Scope**    | Define the topics the AI knows about (e.g., \"Cryptocurrency and blockchain\"). |\n| **Preferred Language** | Choose the AI's language for responses.                                    |\n| **Custom Instructions**| Add unique instructions for your AI to follow.                            |\n\n---\n\n## 🚀 Tech Stack\n- **Frontend**: [Streamlit](https://streamlit.io/)  \n- **Backend**: [OpenAI API](https://platform.openai.com/docs/)  \n- **Styling**: Custom CSS  \n\n---\n\n## 🤝 Contributing\nContributions are welcome! Follow these steps to get started:  \n1. Fork the repository.  \n2. Create a new branch:  \n   ```bash\n   git checkout -b feature-branch-name\n   ```\n3. Commit your changes:  \n   ```bash\n   git commit -m \"Add feature description\"\n   ```\n4. Push to the branch:  \n   ```bash\n   git push origin feature-branch-name\n   ```\n5. Open a Pull Request.  \n\n---\n\n## 📜 License\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%2Fthecarbun%2Fperso9","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthecarbun%2Fperso9","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthecarbun%2Fperso9/lists"}