{"name":"ClickUi: Your Cross-Platform AI Assistant for Local and Cloud Models","description":"ClickUi is a powerful, open-source AI assistant built entirely in Python, designed for cross-platform use. It seamlessly integrates various AI models, speech recognition, and web scraping capabilities, offering both voice and text interaction modes. This tool allows users to leverage local or paid API models, providing a comprehensive and customizable AI experience directly on their computer.","github":"https://github.com/CodeUpdaterBot/ClickUi","url":"https://osrepos.com/repo/codeupdaterbot-clickui","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/codeupdaterbot-clickui","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/codeupdaterbot-clickui.md","json":"https://osrepos.com/repo/codeupdaterbot-clickui.json","topics":["AI","Python","Open Source","Desktop Assistant","ChatGPT","Ollama","Whisper","Speech Recognition"],"keywords":["AI","Python","Open Source","Desktop Assistant","ChatGPT","Ollama","Whisper","Speech Recognition"],"stars":null,"summary":"ClickUi is a powerful, open-source AI assistant built entirely in Python, designed for cross-platform use. It seamlessly integrates various AI models, speech recognition, and web scraping capabilities, offering both voice and text interaction modes. This tool allows users to leverage local or paid API models, providing a comprehensive and customizable AI experience directly on their computer.","content":"## ClickUi: Your Cross-Platform AI Assistant for Local and Cloud Models\n\n### Introduction\n\nClickUi is an innovative, open-source AI assistant built entirely in Python, designed to bring the power of artificial intelligence directly to your desktop. It empowers users to interact with various AI models, supporting both local solutions like Ollama and paid API services such as OpenAI, Claude, and Google. With its intuitive interface, accessible via a simple `Ctrl+k` hotkey, ClickUi offers a seamless experience for voice and text interactions, file attachments, and integrated web searches. It aims to be the most widely used computer-based AI assistant, providing a versatile and customizable tool for enhanced productivity.\n\n### Installation\n\nGetting started with ClickUi involves a few straightforward steps, primarily leveraging Conda for environment management. For Windows users, an `Install.bat` script is available for a simplified setup.\n\n**Manual Installation Steps:**\n\n1.  **Install Anaconda/Conda:** Download and install Anaconda or Conda from [https://www.anaconda.com/download/success](https://www.anaconda.com/download/success){:target=\"_blank\"}.\n2.  **Clone the Repository:** Obtain the ClickUi source code by cloning its GitHub repository.\n3.  **Create and Activate Conda Environment:** Navigate to the cloned directory in your terminal and run:\n    bash\n    conda create --name click_ui --file conda_packages.txt\n    conda activate click_ui\n    \n4.  **Install Python Dependencies:** Install the required Python packages:\n    bash\n    pip install -r requirements.txt\n    \n5.  **Configure API Keys:** Edit the `.voiceconfig` file in the root directory to set up your API keys and preferred engine/model.\n6.  **Start the Program:** Run `python clickui.py` from your activated Conda environment. Once you see \"Ready!...\", press `Ctrl+k` to launch the interface.\n\n### Examples\n\nClickUi integrates several powerful functionalities to provide a comprehensive AI experience.\n\n**Voice Interaction:**\nLeverage Whisper for automatic speech recognition and Kokoro for text-to-speech, enabling natural voice conversations with your AI assistant.\n\npython\nimport whisper as openai_whisper\n\nwhisper_model = openai_whisper.load_model(\"base\", device='cuda')\n\ndef transcribe_audio(audio_data, samplerate):\n    # ... (simplified for brevity) ...\n    result = whisper_model.transcribe(temp_wav_name, fp16=False)\n    return result[\"text\"]\n\n\n**Text Chat:**\nEngage with AI models through a familiar text-based chat interface, supporting direct queries and responses.\n\npython\nclass ChatDialog(QWidget):\n    # ...\n    def handle_reply_send(self):\n        text = self.reply_line.text().strip()\n        if text:\n            self.add_message(text, role=\"user\")\n            self.reply_line.clear()\n            # ... AI processing ...\n\n\n**File Attachments:**\nEasily attach text-based files (e.g., `.txt`, `.csv`, `.xlsx`) via drag-and-drop, allowing the AI to process and respond based on their content.\n\npython\nclass FileDropLineEdit(QLineEdit):\n    file_attached = Signal(list)\n\n    def dropEvent(self, event):\n        if event.mimeData().hasUrls():\n            attachments = []\n            for url in event.mimeData().urls():\n                file_path = url.toLocalFile()\n                ext = os.path.splitext(file_path)[1].lower()\n                if ext in ['.txt', '.csv', '.xlsx', '.xls']:\n                    # ... read file content ...\n                    attachments.append({'filename': file_name, 'content': content})\n            if attachments:\n                self.attachments = attachments\n                self.file_attached.emit(attachments)\n            event.acceptProposedAction()\n        else:\n            super().dropEvent(event)\n\n\n**Google Search Integration:**\nPerform real-time Google searches directly from the assistant to fetch up-to-date information and enhance AI responses.\n\npython\ndef google_search(query: str) -> str:\n    # ...\n    url = f\"https://www.google.com/search?q={encoded_query}\"\n    with sync_playwright() as p:\n        browser = p.chromium.launch(headless=True, args=[\"--disable-blink-features=AutomationControlled\"])\n        page = context.new_page()\n        page.goto(url)\n        page.wait_for_load_state(\"networkidle\")\n        html = page.content()\n        browser.close()\n    soup = BeautifulSoup(html, 'html.parser')\n    text = soup.get_text()\n    cleaned_text = ' '.join(text.split())[0:5000]\n    return cleaned_text\n\n\n**AI Models Integration:**\nClickUi supports a wide range of AI models, including OpenAI, Google, Ollama, Claude, Groq, and OpenRouter, allowing users to switch between them based on their needs.\n\npython\ndef call_openai(prompt: str, model_name: str, reasoning_effort: str) -> str:\n    import openai\n    # ...\n    openai.api_key = OPENAI_API_KEY\n    # ... API call logic ...\n    try:\n        response = openai.chat.completions.create(**api_params)\n    except Exception as e:\n        print(f\"Error connecting to OpenAI: {e}\")\n        return \"\"\n    # ... response handling ...\n\n\n### Why Use It\n\nClickUi stands out as a versatile and powerful AI assistant for several reasons:\n\n*   **Unparalleled Versatility:** Seamlessly switch between various local and cloud-based AI models, offering flexibility to choose the best tool for any task.\n*   **Comprehensive Feature Set:** From natural voice interactions and text chat to intelligent web scraping for property lookups and Google searches, ClickUi provides a rich suite of tools.\n*   **Open-Source Empowerment:** Being open-source, ClickUi encourages community contributions and allows for deep customization, ensuring it evolves with user needs.\n*   **Cross-Platform Accessibility:** Built purely in Python, it's designed to run efficiently across Windows, macOS, and Linux, making advanced AI accessible to everyone.\n*   **Enhanced Productivity:** With quick access via a global hotkey and integrated functionalities, ClickUi streamlines workflows and boosts efficiency for daily tasks.\n\n### Links\n\n*   **GitHub Repository:** [https://github.com/CodeUpdaterBot/ClickUi](https://github.com/CodeUpdaterBot/ClickUi){:target=\"_blank\"}\n*   **1-Minute Demo Video:** [https://youtu.be/oH-A1hSdVKQ](https://youtu.be/oH-A1hSdVKQ){:target=\"_blank\"}","metrics":{"detailViews":9,"githubClicks":14},"dates":{"published":null,"modified":"2025-12-09T20:00:58.000Z"}}