{"id":14105945,"url":"https://github.com/qwersyk/Newelle","last_synced_at":"2025-08-01T05:31:35.869Z","repository":{"id":174370843,"uuid":"652134847","full_name":"qwersyk/Newelle","owner":"qwersyk","description":"Newelle - Your Ultimate Virtual Assistant","archived":false,"fork":false,"pushed_at":"2024-10-07T15:21:00.000Z","size":4732,"stargazers_count":137,"open_issues_count":7,"forks_count":16,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-10-10T22:15:47.065Z","etag":null,"topics":["adwaita","app","gnome","gtk","gtk4","linux"],"latest_commit_sha":null,"homepage":"https://flathub.org/apps/io.github.qwersyk.Newelle","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/qwersyk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","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-06-11T07:43:48.000Z","updated_at":"2024-10-10T05:00:44.000Z","dependencies_parsed_at":null,"dependency_job_id":"dd084418-2e7f-4c8d-a57c-85059ddfd69c","html_url":"https://github.com/qwersyk/Newelle","commit_stats":{"total_commits":240,"total_committers":9,"mean_commits":"26.666666666666668","dds":0.4375,"last_synced_commit":"7e84f8a8b75d19a4f6523d5df32717a590aba737"},"previous_names":["qwersyk/assistant","qwersyk/newelle"],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qwersyk%2FNewelle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qwersyk%2FNewelle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qwersyk%2FNewelle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qwersyk%2FNewelle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/qwersyk","download_url":"https://codeload.github.com/qwersyk/Newelle/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228334171,"owners_count":17903760,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["adwaita","app","gnome","gtk","gtk4","linux"],"created_at":"2024-08-14T09:01:14.413Z","updated_at":"2025-08-01T05:31:35.843Z","avatar_url":"https://github.com/qwersyk.png","language":"Python","funding_links":[],"categories":["Python","Desktop","Applications","12. User Interfaces \u0026 Self-hosted Platforms","Productivity"],"sub_categories":["Good Applications","Productivity and Time","Chat Bots and Virtual assistants"],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/qwersyk/Newelle/master/data/icons/hicolor/scalable/apps/io.github.qwersyk.Newelle.svg\" alt=\"Newelle\" width=\"192\" height=\"192\"/\u003e\n  \u003cbr\u003e\n  Newelle - Your Ultimate Virtual Assistant\n\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://flathub.org/apps/details/io.github.qwersyk.Newelle\"\u003e\n      \u003cpicture\u003e\n        \u003csource srcset=\"https://dl.flathub.org/assets/badges/flathub-badge-i-en.svg\" media=\"(prefers-color-scheme: light)\"\u003e\n        \u003csource srcset=\"https://raw.githubusercontent.com/qwersyk/Assets/main/flathub-badge-dark.svg\" media=\"(prefers-color-scheme: dark)\"\u003e\n        \u003cimg width=\"200\" alt=\"Download on Flathub\" src=\"https://dl.flathub.org/assets/badges/flathub-badge-i-en.svg\"/\u003e\n      \u003c/picture\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/topics/newelle-extension\"\u003e\n      \u003cpicture\u003e\n        \u003csource srcset=\"https://raw.githubusercontent.com/qwersyk/Assets/main/newelle-extension.svg\" media=\"(prefers-color-scheme: light)\"\u003e\n        \u003csource srcset=\"https://raw.githubusercontent.com/qwersyk/Assets/main/newelle-extension-dark.svg\" media=\"(prefers-color-scheme: dark)\"\u003e\n        \u003cimg width=\"200\" alt=\"Download on Flathub\" src=\"https://raw.githubusercontent.com/qwersyk/Assets/main/newelle-extension.svg\"/\u003e\n      \u003c/picture\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/qwersyk/Newelle/wiki\"\u003e\n      \u003cpicture\u003e\n        \u003csource srcset=\"https://raw.githubusercontent.com/qwersyk/Assets/main/newelle-wiki.svg\" media=\"(prefers-color-scheme: light)\"\u003e\n        \u003csource srcset=\"https://raw.githubusercontent.com/qwersyk/Assets/main/newelle-wiki-dark.svg\" media=\"(prefers-color-scheme: dark)\"\u003e\n        \u003cimg width=\"200\" alt=\"Wiki for Newelle\" src=\"https://raw.githubusercontent.com/qwersyk/Assets/main/newelle-wiki.svg\"/\u003e\n      \u003c/picture\u003e\n    \u003c/a\u003e\n    \u003cbr\u003e\n\u003c/p\u003e\n\nhttps://github.com/user-attachments/assets/909edf0e-5a79-40c2-a3ef-cb5b2b18abfc\n\n# Features\n\n\n- 🎨 **Advanced Customization**: Tailor the application with a wide range of settings\n- 🚀 **Flexible Model Support**: Choose from mutliple AI models and providers to fit your specific needs\n- 💻 **Terminal Command Exection**: Execute commands suggested by the AI on the fly\n- 🧩 **Extensions**: Add your own functionalities and models to Newelle\n- 🗣 **Voice support**: Chat hands free with Newelle, supporting many Speech To Text and TTS models, with translation options\n- 🧠 **Long Term Memory**: Remember conversations from previous chats\n- 💼 **Chat with documents**: Chat with your own documents\n- 🔎 **Web Search**: Provide reliable answers using Web Search\n- 🌐 **Website Reading**: Scrap informations from websites by appending the prefix #https://.. in the prompt\n- 👤 **Profile Manager**: Create settings profiles and switch between them\n- 📁 **Builtin File Manager**: Manage you files with the help of AI\n- 📝 **Rich Formatting**: Supports both Markdown and LaTeX\n- ✏️ **Chat editing**: Edit or remove any message and manage your prompts easily\n\n\u003cpicture\u003e\n  \u003csource srcset=\"https://raw.githubusercontent.com/qwersyk/Newelle/master/screenshots/3w.png\" media=\"(prefers-color-scheme: light)\"\u003e\n  \u003csource srcset=\"https://raw.githubusercontent.com/qwersyk/Newelle/master/screenshots/3b.png\" media=\"(prefers-color-scheme: dark)\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/qwersyk/Newelle/master/screenshots/3w.png\" alt=\"screenshot\"\u003e\n\u003c/picture\u003e\n\n# Extensions\n\nNewelle supports extensions to extend its functionality. You can either\nuse [existing extensions](https://github.com/topics/newelle-extension) or create your own to add new features to the\napplication.\n\n\u003cpicture\u003e\n  \u003csource srcset=\"https://raw.githubusercontent.com/qwersyk/Newelle/master/screenshots/2w.png\" media=\"(prefers-color-scheme: light)\"\u003e\n  \u003csource srcset=\"https://raw.githubusercontent.com/qwersyk/Newelle/master/screenshots/2b.png\" media=\"(prefers-color-scheme: dark)\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/qwersyk/Newelle/master/screenshots/2w.png\" alt=\"screenshot\"\u003e\n\u003c/picture\u003e\n\n## Mini Window Mode\n\nA lightweight version of Newelle that can be triggered via keyboard shortcuts.\n\n### Configuration\n\n#### 1. Setup Hotkeys\nAs an example, to set the mini window launch's hotkey to Ctrl+Space, execute this command:\n```bash\n/bin/bash -c 'flatpak run --command=gsettings io.github.qwersyk.Newelle set io.github.qwersyk.Newelle startup-mode \"mini\" \u0026\u0026 flatpak run io.github.qwersyk.Newelle'\n```\nAfter that, enable the hotkey in settings.\n\n#### 2. Enable Window Centering\nFor GNOME desktop environment users, you may need to enable automatic window centering:\n\n```bash\ngsettings set org.gnome.mutter center-new-windows true\n```\n\n\u003cpicture\u003e\n  \u003csource srcset=\"https://raw.githubusercontent.com/qwersyk/Newelle/master/screenshots/4w.png\" media=\"(prefers-color-scheme: light)\"\u003e\n  \u003csource srcset=\"https://raw.githubusercontent.com/qwersyk/Newelle/master/screenshots/4b.png\" media=\"(prefers-color-scheme: dark)\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/qwersyk/Newelle/master/screenshots/4w.png\" alt=\"screenshot\"\u003e\n\u003c/picture\u003e\n\n# Installation\n\n\u003ca href=\"https://github.com/qwersyk/Newelle/archive/refs/heads/master.zip\"\u003e\n  \u003cpicture\u003e\n    \u003csource srcset=\"https://raw.githubusercontent.com/qwersyk/Assets/main/builder.svg\" media=\"(prefers-color-scheme: light)\"\u003e\n    \u003csource srcset=\"https://raw.githubusercontent.com/qwersyk/Assets/main/builder-dark.svg\" media=\"(prefers-color-scheme: dark)\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/qwersyk/Assets/main/builder.svg\" alt=\"builder\"\u003e\n  \u003c/picture\u003e\n\u003c/a\u003e\nThere are two ways of doing this\n\n  * `install.sh`\n    1. Install the latest Gnome SDK\n    2. Run `sh install.sh`\n    3. Profit!\n  * Gnome Builder\n    1. Install GNOME Builder on your system.\n    2. Clone the Newelle repository from GitHub.\n    3. Open the project in GNOME Builder and compile it.\n    4. Once compiled, you can run the program from the compiled executable.\n\n\u003ca href=\"https://nixos.org\"\u003e\n  \u003cpicture\u003e\n    \u003csource srcset=\"https://raw.githubusercontent.com/qwersyk/Assets/main/nix.svg\" media=\"(prefers-color-scheme: light)\"\u003e\n    \u003csource srcset=\"https://raw.githubusercontent.com/qwersyk/Assets/main/nix-dark.svg\" media=\"(prefers-color-scheme: dark)\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/qwersyk/Assets/main/nix.svg\" alt=\"builder\"\u003e\n  \u003c/picture\u003e\n\u003c/a\u003e\n\nWith nix, you can run the app without installing by executing this command:\n```sh\nnix run github:qwersyk/Newelle\n```\nIf you want the latest commit version, you can clone this repository and execute `nix run .` to start the program or `nix develop .` to start a developer shell\n\n\u003ca href=\"https://github.com/qwersyk/Newelle/actions\"\u003e\n  \u003cpicture\u003e\n    \u003csource srcset=\"https://raw.githubusercontent.com/qwersyk/Assets/main/beta.svg\" media=\"(prefers-color-scheme: light)\"\u003e\n    \u003csource srcset=\"https://raw.githubusercontent.com/qwersyk/Assets/main/beta-dark.svg\" media=\"(prefers-color-scheme: dark)\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/qwersyk/Assets/main/beta.svg\" alt=\"beta\"\u003e\n  \u003c/picture\u003e\n\u003c/a\u003e\n\n\u003e [!WARNING]\n\u003e Localizations will not work on these builds! If you want your language to work, go to the\n\u003e \"Builder\" section instead\n1. Download the latest release from the [Github Actions](https://github.com/qwersyk/Newelle/actions)\n2. Extract the downloaded package.\n3. Install a flatpak package.\n\n\u003ca href=\"https://flathub.org/apps/io.github.qwersyk.Newelle\"\u003e\n  \u003cpicture\u003e\n    \u003csource srcset=\"https://raw.githubusercontent.com/qwersyk/Assets/main/flathub.svg\" media=\"(prefers-color-scheme: light)\"\u003e\n    \u003csource srcset=\"https://raw.githubusercontent.com/qwersyk/Assets/main/flathub-dark.svg\" media=\"(prefers-color-scheme: dark)\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/qwersyk/Assets/main/flathub.svg\" alt=\"flathub\"\u003e\n  \u003c/picture\u003e\n\u003c/a\u003e\n\n1. Ensure you have set up both flatpak and flathub\n2. Install Newelle by executing: `flatpak install flathub io.github.qwersyk.Newelle`\n\n# Permission\n\n\u003e [!IMPORTANT]\n\u003e The Flathub version of Newelle is restricted to the `.var/app/io.github.qwersyk.Newelle` folder and operates within a\n\u003e Flatpak virtualized environment, limiting its capabilities.\n\nTo extend Newelle's permissions, either execute this command to temporarily grant its access:\n```sh\nflatpak run --talk-name=org.freedesktop.Flatpak --filesystem=home io.github.qwersyk.Newelle\n```\nor adjust the permissions permanently using [Flatseal](https://flathub.org/apps/details/com.github.tchx84.Flatseal):\n  - Open Flatseal, find \"newelle\" and enable both \"All user files\" and \"Session Bus\"\n\t- Add `org.freedesktop.Flatpak` to run outside the sandbox.\n\u003e [!WARNING]\n\u003e Be cautious when enabling these options. They reduce security by exposing your data and terminal. Avoid sharing\n\u003e personal information, and understand that we can't guarantee the privacy of your chat data or prevent potential risks\n\u003e from proprietary models.\n\n# Honorable Mentions of Newelle's forks\n\n\u003ca href=\"https://github.com/qwersyk/Newelle/tree/aarch64\"\u003e\n  \u003cpicture\u003e\n    \u003csource srcset=\"https://raw.githubusercontent.com/qwersyk/Assets/main/aarch64.svg\" media=\"(prefers-color-scheme: light)\"\u003e\n    \u003csource srcset=\"https://raw.githubusercontent.com/qwersyk/Assets/main/aarch64-dark.svg\" media=\"(prefers-color-scheme: dark)\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/qwersyk/Assets/main/aarch64.svg\" alt=\"aarch64\"\u003e\n  \u003c/picture\u003e\n\u003c/a\u003e\n\n\n**[Newelle Lite](https://github.com/qwersyk/Newelle/tree/aarch64)** - Your Virtual Assistant for aarch64\n\n\u003ca href=\"https://github.com/NyarchLinux/NyarchAssistant\"\u003e\n  \u003cpicture\u003e\n    \u003csource srcset=\"https://raw.githubusercontent.com/qwersyk/Assets/main/nyarch.svg\" media=\"(prefers-color-scheme: light)\"\u003e\n    \u003csource srcset=\"https://raw.githubusercontent.com/qwersyk/Assets/main/nyarch-dark.svg\" media=\"(prefers-color-scheme: dark)\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/qwersyk/Assets/main/nyarch.svg\" alt=\"nyarch\"\u003e\n  \u003c/picture\u003e\n\u003c/a\u003e\n\n**[Nyarch Assistant](https://github.com/NyarchLinux/NyarchAssistant)** - Your ultimate Waifu AI Assistant\n\n\u003cpicture\u003e\n  \u003csource srcset=\"https://raw.githubusercontent.com/NyarchLinux/NyarchAssistant/refs/heads/master/screenshots/1w.png\" media=\"(prefers-color-scheme: light)\"\u003e\n  \u003csource srcset=\"https://raw.githubusercontent.com/NyarchLinux/NyarchAssistant/refs/heads/master/screenshots/1b.png\" media=\"(prefers-color-scheme: dark)\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/NyarchLinux/NyarchAssistant/refs/heads/master/screenshots/1w.png\" alt=\"screenshot\"\u003e\n\u003c/picture\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqwersyk%2FNewelle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqwersyk%2FNewelle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqwersyk%2FNewelle/lists"}