Skip to main content

A clipboard-activated AI assistant powered by Gemini.

Project description

ClipAsh clipboard AI ⚡

Your secret AI assistant, just a hotkey away.

ClipAsh is a stealthy, clipboard-activated AI tool that lives in your background. Copy any text, press a hotkey, and get an answer from Google's Gemini directly back on your clipboard. It's designed for speed, efficiency, and to give you an unfair advantage in... well, anything.

🔥 Features

  • Clipboard Activated: Just copy text (Ctrl+C) and press the hotkey. No need to open a new window or website.
  • System-Wide Hotkey: Works anywhere on your system—browser, IDE, text editor, PDF, you name it.
  • Conversation Memory: ClipAsh remembers your last 50 queries in a session, so you can ask follow-up questions and get context-aware answers.
  • Stealth Mode:
    • Runs silently in the background with no visible window.
    • Chat history is encrypted and stored in a hidden system file.
    • Notifications are disguised as boring system messages (e.g., "Driver Update," "Files Synced").
  • Kill Switch & Evidence Wipe: A special hotkey not only stops the script but also deletes all evidence, including the encrypted history, config file, and encryption key.
  • Powered by Gemini: Uses Google's powerful Gemini models with a fallback system for reliability.

🚀 Installation

Getting ClipAsh is as simple as a pip command.

pip install clipash

🛠️ First-Time Setup

The first time you run ClipAsh, it will need a Gemini API key to work its magic.

  1. Open your terminal (Command Prompt, PowerShell, etc.).
  2. Run the command:
    clipash
    

After this , ClipAsh will run silently in the background and will never ask you again.

💡 How to Use

The workflow is designed to be lightning fast:

  1. Copy: Select any text on your screen and press Ctrl+C.
  2. Call Aisha: Press the hotkey Ctrl+Shift+A.
  3. Paste: Wait for the disguised system notification, then press Ctrl+V to paste the AI-generated answer.

⌨️ Hotkeys

  • Activate ClipAsh: Ctrl + Shift + A
  • Stop & Wipe All Data: Ctrl + Z (Use this "safe word" to instantly terminate the program and delete all history files).

📄 License

This project is licensed under the MIT License.

Coded with ❤️ by Aisha, based on the genius ideas of Heisenberg.

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.6.tar.gz (5.3 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.6-py3-none-any.whl (5.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: clipash-1.0.6.tar.gz
  • Upload date:
  • Size: 5.3 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.6.tar.gz
Algorithm Hash digest
SHA256 352e26103a2f408366061dce5d0db7783c495fcbe84957a702269a93c9fc23bd
MD5 a943dd60b0f52be3a44ae2fcac4e16a5
BLAKE2b-256 738c05bd96edf8a00d9d48fa4982198be69448c2f24e07b0fa5dab24c4a5c79b

See more details on using hashes here.

File details

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

File metadata

  • Download URL: clipash-1.0.6-py3-none-any.whl
  • Upload date:
  • Size: 5.6 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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 b9e56e8cb0fdcc648bf61d9c2cdf607b430e245706dda742bc44f393f2114daa
MD5 f5b7c4904efc544f9de656ded7553d5a
BLAKE2b-256 180116c40867db0517171282623dd92770db0c41aaede5ecc191b69013de5940

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