https://github.com/qwersyk/Newelle

Newelle - Your Ultimate Virtual Assistant
https://github.com/qwersyk/Newelle

adwaita app gnome gtk gtk4 linux

Last synced: 8 days ago
JSON representation

Newelle - Your Ultimate Virtual Assistant

• Host: GitHub
• URL: https://github.com/qwersyk/Newelle
• Owner: qwersyk
• License: gpl-3.0
• Created: 2023-06-11T07:43:48.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2024-10-07T15:21:00.000Z (2 months ago)
• Last Synced: 2024-10-10T22:15:47.065Z (2 months ago)
• Topics: adwaita, app, gnome, gtk, gtk4, linux
• Language: Python
• Homepage: https://flathub.org/apps/io.github.qwersyk.Newelle
• Size: 4.51 MB
• Stars: 137
• Watchers: 6
• Forks: 16
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: COPYING

Awesome Lists containing this project

• awesome-gnome - Newelle - Virtual assistant (local, based on GPT4All) that interacts with the system by running shell commands and execute Python code. (Applications / Productivity and Time)

README

        


  

  


  Newelle - Your Ultimate Virtual Assistant





  

    

  

  

    

  

  

    

  

  








    

  

  




![screenshot](https://raw.githubusercontent.com/qwersyk/Newelle/master/screenshots/1w.png#gh-light-mode-only)

![screenshot](https://raw.githubusercontent.com/qwersyk/Newelle/master/screenshots/1b.png#gh-dark-mode-only)

# Features

- **Terminal Command Execution**: Execute terminal commands directly through the AI.

- **Advanced Customization**: Tailor the application with a wide range of settings.

- **Flexible Model Support**: Choose from multiple AI models to fit your specific needs.

![screenshot](https://raw.githubusercontent.com/qwersyk/Newelle/master/screenshots/3w.png#gh-light-mode-only)

![screenshot](https://raw.githubusercontent.com/qwersyk/Newelle/master/screenshots/3b.png#gh-dark-mode-only)

# Extensions

Newelle supports extensions to enhance its functionality. You can either use [existing extensions](https://github.com/topics/newelle-extension) or create your own to add new features to the application.

![screenshot](https://raw.githubusercontent.com/qwersyk/Newelle/master/screenshots/2w.png#gh-light-mode-only)

![screenshot](https://raw.githubusercontent.com/qwersyk/Newelle/master/screenshots/2b.png#gh-dark-mode-only)

# Installation

![builder](https://raw.githubusercontent.com/qwersyk/Assets/main/builder.svg#gh-light-mode-only)

![builder](https://raw.githubusercontent.com/qwersyk/Assets/main/builder-dark.svg#gh-dark-mode-only)

1. Install GNOME Builder on your system.

2. Clone the Newelle repository from GitHub.

3. Open the project in GNOME Builder and compile it.

4. Once compiled, you can run the program from the compiled executable.

![beta](https://raw.githubusercontent.com/qwersyk/Assets/main/beta.svg#gh-light-mode-only)

![beta](https://raw.githubusercontent.com/qwersyk/Assets/main/beta-dark.svg#gh-dark-mode-only)

1. Download the latest release from the [Github Actions](https://github.com/qwersyk/Newelle/actions)

2. Extract the downloaded package.

3. Install a flatpak package.

![flathub](https://raw.githubusercontent.com/qwersyk/Assets/main/flathub.svg#gh-light-mode-only)

![flathub](https://raw.githubusercontent.com/qwersyk/Assets/main/flathub-dark.svg#gh-dark-mode-only)

1. Ensure you have Flatpak installed on your system.

2. Install Newelle by executing: `flatpak install flathub io.github.qwersyk.Newelle`

# Permission

> [!IMPORTANT]

> The Flathub version of Newelle is restricted to the `.var/app/io.github.qwersyk.Newelle` folder and operates within a Flatpak virtualized environment, limiting its capabilities.

To extend functionality, you can either temporarily grant access with:

```flatpak run --talk-name=org.freedesktop.Flatpak --filesystem=home io.github.qwersyk.Newelle```

or adjust settings permanently using Flatseal:

- Open Flatseal, find "Newelle," enable "All user files" and "Session Bus," and add `org.freedesktop.Flatpak` to run outside the sandbox.

> [!WARNING]

> Be cautious when enabling these options. They reduce security by exposing your data and terminal. Avoid sharing personal information, and understand that we can't guarantee the privacy of your chat data or prevent potential risks from proprietary models.