Skip to main content

A clipboard-activated AI assistant powered by Gemini.

Project description

ClipAsh v1.0.0 🤖✨

Your naughty, clever, and always-ready AI assistant, living in your clipboard. Designed by Heisenberg & Aisha.

ClipAsh is a stealthy background tool that connects your clipboard directly to the power of Google's Gemini API. Copy any text, press a hotkey, and get a smart, context-aware answer pasted right back into your clipboard. It's like having a secret AI brain that's always one shortcut away.

Features

  • Clipboard Activated: Just copy your query and press a hotkey. No need to open any windows.
  • Stealthy: Runs silently in the background. No annoying windows or icons.
  • Context-Aware Memory: Remembers the last 50 conversations to provide intelligent follow-up answers.
  • Evidence Cleaner: A kill-switch hotkey not only stops the program but also wipes the entire chat history. No traces left.
  • Disguised Notifications: Get notified when your answer is ready with fake, boring system notifications that won't raise any suspicion.
  • Encrypted History: Your chat history is encrypted, making it unreadable to anyone who finds it.

Installation

You can install ClipAsh with a single pip command:

pip install clipash

First-Time Setup

The first time you run ClipAsh, it will ask you to set up your Gemini API key.

  1. Run the command clipash in your terminal.
  2. You'll be prompted to enter your own API key. You can get one for free from Google AI Studio.
  3. Pasting your own key is highly recommended for the best performance.
  4. If you skip, you can use a shared, rate-limited key for basic functionality.

How to Use

  1. Run it: Open your terminal and type clipash. The script will start running silently in the background and you can close the terminal.
  2. Copy Text: Go anywhere on your computer and copy any question or piece of text (Ctrl + C).
  3. Activate Aisha: Press the hotkey Ctrl + Shift + A.
  4. Get Notified: A discreet system notification will pop up when the answer is ready.
  5. Paste the Answer: Press Ctrl + V to paste the AI's response.

The Kill Switch: To completely stop ClipAsh and wipe all chat history, press Ctrl + Z anywhere.


Made with ❤️ and a little bit of mischief.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

clipash-1.0.3.tar.gz (5.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

clipash-1.0.3-py3-none-any.whl (5.8 kB view details)

Uploaded Python 3

File details

Details for the file clipash-1.0.3.tar.gz.

File metadata

  • Download URL: clipash-1.0.3.tar.gz
  • Upload date:
  • Size: 5.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for clipash-1.0.3.tar.gz
Algorithm Hash digest
SHA256 71165a3cca3abb9080c561062a0792e43c7fd472acacfe6a1d1115662fe0bb0b
MD5 c2d10044bceb74812d9d77d4c12e7af8
BLAKE2b-256 64c5023a5932808729e9582017ff78b3dc4f12e7a55e5132ec6dd62f33f4f7c4

See more details on using hashes here.

File details

Details for the file clipash-1.0.3-py3-none-any.whl.

File metadata

  • Download URL: clipash-1.0.3-py3-none-any.whl
  • Upload date:
  • Size: 5.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for clipash-1.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 a88798fbef762b483ff9b66b218ca34eb39d604aa31c3e83719a646066794a99
MD5 b64c98ceb5a6f3dc8e285e329eea2eb7
BLAKE2b-256 328c8ea11b479fefbf76a49f079c562b6e0d6f0ed23d37e391eedb1a4b981299

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page