Desktop Assistant
Desktop Assistant

Desktop
Assistant

version
2.0.0
platform
Windows
interface
CustomTkinter
chatbot
Google Gemini

Create files and folders on your Desktop from one window, and talk to a chatbot powered by Google Gemini.

Download for Windows .exe View the repository

Opens the latest release on GitHub.

demo video

//features

Make files, make folders, ask questions.

file

Create a file

Type a file name and Desktop Assistant creates the file on your Desktop.

folder

Create a folder

Enter a name and press the button. The folder appears on your Desktop and the status line confirms it.

folder + files

Create a folder with several files

Make a folder and fill it with multiple files in one step instead of creating each file by hand.

ai chat

Talk to the chatbot

Ask questions in the AI Chat tab and watch the reply appear as it is written. It uses your own Gemini API key, so your usage stays on your own account.

//install

Download, extract, run.

  1. Download the latest release from the GitHub Releases page using the download button above.

  2. Extract the zip if you downloaded one, then open DesktopAssistant.exe from inside the extracted folder. The app needs the files next to it, so do not move the exe on its own.

  3. Allow it if Windows warns you. The app is not code-signed, so Windows may show a SmartScreen message. Choose More info, then Run anyway.

// or run it from source (Python 3.10+)

git clone https://github.com/hannanthedev/Desktop-assistant.git cd Desktop-assistant python -m pip install customtkinter google-genai python-dotenv python gui.py

//api key

The chat needs your own Gemini key.

File and folder tools work without one. To use the AI Chat tab, create a free key in Google AI Studio and give it to the app. It takes about two minutes. Google sets the usage limits for your key.

  1. Open the API keys page in Google AI Studio:

    https://aistudio.google.com/api-keys

  2. Sign in with your Google account.

  3. Choose Create API key, then copy the key it shows you. If it asks for a project, pick one or create a new one.

  4. Create a file named .env in the same folder as DesktopAssistant.exe. In Notepad, choose Save as, set Save as type to All files, and type .env as the file name. Otherwise Windows saves it as .env.txt and the app will not find it.

  5. Add this line to the file and replace the placeholder with your key. Use no quotes and no spaces around the equals sign.

    gen_api=PASTE_YOUR_KEY_HERE
  6. Save the file and start Desktop Assistant. Open the AI Chat tab and send a message.

Keep your key private. Do not post it, send your .env file to anyone, or upload it to GitHub. If it leaks, delete the key in AI Studio and create a new one.

//contribute

All contributions are welcome.

Report a bug, suggest a feature, improve the documentation or send a pull request. For a large change, open an issue first so we can talk it through.

// the short version

git checkout -b my-change python gui.py // test it git push origin my-change

Then open a pull request on GitHub and describe what you changed and why.