🚀 Tangent - AI Text Transformation Tool

Tangent is a smart, system-wide text transformation tool powered by the Google Gemini API. It runs silently in your system tray, allowing you to use custom, AI-powered hotkeys in any application on your computer. Fix typos, formalize emails, refactor code, or create any text transformation you can imagine, all without leaving your current window. This project helps users improve typing accuracy and speed.

---

Tangent

✨ Features

• 🎯 System-Wide Hotkeys: Use your custom shortcuts in any text field, on any application
• 🔄 Multiple AI Modes: Configure different hotkeys for different tasks
• 🔒 Secure API Key Management: Keep your Google Gemini API key safe using local .env file
• 🎨 User-Friendly Settings Manager: Graphical interface for managing hotkeys and prompts
• 📌 System Tray Control: Runs discreetly in system tray with easy access
• 💾 Local Caching: Improves speed and reduces API calls

---

🛠️ Technologies Used

Technology	Purpose
Python 3.10+	Core programming language
Google Gemini API	AI-powered text transformations
Tkinter	GUI for settings management
Pystray	System tray integration
PyInstaller	Executable building

---

## 📋 Prerequisites

Before running this project, ensure you have the following:

• Python 3.10+
• Google Gemini API Key
• Windows Operating System

---

⚡ Quick Setup

1. Clone the Repository

git clone https://github.com/your-username/tangent.git
cd tangent
# On Windows
python -m venv env
.\env\Scripts\activate

# On macOS/Linux
python -m venv env
source env/bin/activate

# 3. Install Dependencies

```bash
pip install -r requirements.txt

4. Configure Environment

Create a .env file in the project root:

api-key='add yout api key

5. Run the Application

python settings_gui.py

🎯 How to Use

Launch Settings Manager: Run python settings_gui.py to open the configuration interface.

Configure Hotkeys: Use the GUI to add or edit your desired hotkeys and AI prompts.

Save Configuration: Click "Save to JSON" to store your settings.

Launch Service: Click "🚀 Save & Launch Hotkey Service" to start the system tray application.

Use Anywhere: Select text in any application and press your configured hotkeys to transform text.

##You will find Tangent Logo in the stray bar. You can manage it by right-clicking.

# 📦 Building Executable

To create a standalone Windows executable:

Prepare Assets: Ensure you have logo.ico and logo.png in the project directory.

Run Build Script:

.\build.bat

Distribute: The complete application will be in dist\Tangent folder.

🤝 Contributing

We welcome contributions to Tangent! If you'd like to add new features follow these steps:

1. Fork the repository.
2. Create a new branch (git checkout -b feature-branch).
3. Add your changes (git add .).
4. Commit your changes (git commit -m 'Add new feature').
5. Push to the branch (git push origin feature-branch).
6. Open a Pull Request to the main branch.

Before submitting a pull request, ensure your code is properly formatted and includes necessary comments.

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

🌟 Acknowledgements

Built with ❤️ using Python and Google Gemini API.

Special thanks to open-source contributors and the development community.

Icons and animations designed for seamless user experience.