{"id":35162276,"url":"https://github.com/pdschneider/pearl","last_synced_at":"2026-04-02T18:36:49.665Z","repository":{"id":326426080,"uuid":"1104088593","full_name":"pdschneider/Pearl","owner":"pdschneider","description":"Personal Everything Assistant Running Locally","archived":false,"fork":false,"pushed_at":"2026-02-22T15:27:34.000Z","size":599,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-22T20:28:52.057Z","etag":null,"topics":["ai","chatbot","customtkinter","llm","ollama","pearl"],"latest_commit_sha":null,"homepage":"","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/pdschneider.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-11-25T18:29:40.000Z","updated_at":"2026-02-22T15:27:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/pdschneider/Pearl","commit_stats":null,"previous_names":["pdschneider/pearl"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/pdschneider/Pearl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pdschneider%2FPearl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pdschneider%2FPearl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pdschneider%2FPearl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pdschneider%2FPearl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pdschneider","download_url":"https://codeload.github.com/pdschneider/Pearl/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pdschneider%2FPearl/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29959284,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T01:47:18.291Z","status":"online","status_checked_at":"2026-03-01T02:00:07.437Z","response_time":124,"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","customtkinter","llm","ollama","pearl"],"created_at":"2025-12-28T18:43:09.063Z","updated_at":"2026-04-02T18:36:49.647Z","avatar_url":"https://github.com/pdschneider.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pearl — Personal Everything Assistant Running Locally\n\nPearl is your assistant. She is 100% private and runs locally on your computer.\n\n\u003cimg src=\"defaults/assets/Pearl.png\" align=\"right\" width=\"30%\" /\u003e\n\n### ✨ Features\n\n- Private AI chats\n- Dynamic context switching based on keywords\n- Simple setup\n- Saving chats is optional, supporting privacy\n- Offline use is fully supported after setup\n- Sends no data outside the local machine by default\n- Comes with 5 themes\n- Supports file uploads\n- Utilize any Ollama-compatible device on LAN\n\n### 🛠️ Dependencies\n- Ollama with at least one model\n- Kokoro Fast-API for optional TTS integration\n- Docker (a dependency for Kokoro, optional)\n\n### ⚙️ Requirements\n- 4-Core CPU\n- 8GB RAM highly recommended\n- Linux Ubuntu 18.04 or later, or Window 10/11\n- 50GB+ Disk Space recommended\n\n## 📸 View Screenshots\n\u003cdetails\u003e\n\u003csummary\u003e📸 Pearl 1\u003c/summary\u003e\n\n![Pearl Screenshot](Screenshots/Pearl-2.png)\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e📸 Pearl 2\u003c/summary\u003e\n\n![Pearl Screenshot](Screenshots/Pearl-3.png)\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e📸 Pearl 3\u003c/summary\u003e\n\n![Pearl Screenshot](Screenshots/Pearl-1.png)\n\n\u003c/details\u003e\n\n## 🚀 Build\n\n### 🐧 Linux\n\nPearl can be built from source files via Nuitka \u0026 bundled into an AppImage on Linux:\n\n```\npip install -r requirements.txt\n\nnuitka \\\n    --standalone \\\n    --onefile \\\n    --remove-output \\\n    --output-dir=dist \\\n    --enable-plugin=pyside6 \\\n    --enable-plugin=tk-inter \\\n    --include-qt-plugins=platforms,iconengines,imageformats \\\n    --include-package=pyttsx3.drivers \\\n    --include-data-dir=defaults=defaults \\\n    --include-data-files=CHANGELOG.md=CHANGELOG.md \\\n    --include-data-files=README.md=README.md \\\n    pearl.py\n    \n```\n\nSet AppRun inside Pearl.AppDir as executable prior to building the AppImage\n\nCopy pearl.bin to subdirectory Pearl.AppDir/usr/bin\n\nRun this command from the app's root directory:\n`appimagetool Pearl.AppDir Pearl-Linux.AppImage -v`\n\n### 🖥️ Windows\n\nOn Windows, Pearl can also be built via Nuitka\n\n**IMPORTANT: Must have Visual Studio Build Tools installed with C++ / MVSC bindings**\n\n```\npip install -r requirements.txt\n\nnuitka --standalone --msvc=latest --onefile --remove-output --enable-plugin=pyside6 --include-qt-plugins=platforms --enable-plugin=tk-inter --windows-disable-console --output-dir=dist --include-package=pyttsx3.drivers --windows-icon-from-ico=defaults/assets/pearl.ico --include-data-dir=defaults=defaults --include-data-files=CHANGELOG.md=CHANGELOG.md --include-data-files=README.md=README.md pearl.py\n\n```\n\n## 🪲 Report Bugs\nReport bugs via GitHub Issues or to bugs@phillipplays.com.\n\n## 💬 Testimonials\n\n\"I love the Pearl AI! So friendly and sweet.\" - lils_the_gamer1 (Twitch)\n\n\"It was really easy to run with the AppImage. Good job!\" - ChainsawCowboy (Minds)\n\n\"Pearl was just telling me her favorite thing to do is dance. I don't have the heart to tell her that she doesn't have legs.\" - ChainsawCowboy (Minds)\n\n## ⚠️ Disclaimer - Third-Party AI Models\n\nPearl integrates third-party artificial intelligence models selected by the user. The developer of this software is not responsible for the accuracy, appropriateness, legality, or safety of any output generated by these AI models. All responses from the AI are provided \"AS-IS\" with no warrenties of any kind, express or implied. Selecting an AI model, configurings its safeguards, and ensuring safe interaction are entirely the user's responsibility. By using Pearl, you acknowledge that any consequences arising from AI output are solely your own.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpdschneider%2Fpearl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpdschneider%2Fpearl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpdschneider%2Fpearl/lists"}