OpenClam

Homepage: http://openclam.tw

Windows 桌面 AI 搜尋列、翻譯面板、本地 AI 助手。OpenClam 提供類似 PowerToys Run / Fluent Search 的懸浮搜尋體驗，並整合本地 AI 問答與即時翻譯。

一鍵安裝

winget install Python.Python.3.12
py -3.12 -m pip install --upgrade pip
py -3.12 -m pip install git+https://github.com/aaaddress1/OpenClam.git
openclam ui

首次啟動時，OpenClam 會自動下載本機模型：

• AI 模式：qwen2.5:0.5b
• 翻譯面板：Meta 輕量翻譯模型（meta-nllb / CTranslate2）

不需要額外安裝 Ollama。

功能亮點

• 懸浮搜尋列：用 Alt 單按叫出搜尋列，搜尋 App、檔案、資料夾、視窗、瀏覽器紀錄、系統設定。
• 路徑 scoped search：輸入 ~\Desktop 或 ~\Downloads 後按 Tab，將搜尋範圍鎖定到指定資料夾。
• AI mode：輸入 ? 後按空白或 Tab 進入 ClamAI Mode，使用本機 qwen2.5:0.5b 回答問題。
• 翻譯面板：選取文字後連按兩次 Ctrl+C，在游標附近跳出類似 DeepL 的翻譯小窗。
• 右側細節面板：選取搜尋結果時顯示檔案屬性、操作按鈕與可預覽內容。
• 自動模型下載：新使用者第一次啟動時會自動下載所需模型並快取到本機 .openclam/。

使用方式

啟動 UI

openclam ui

啟動後可做什麼

• 直接輸入關鍵字：混合搜尋 App、檔案、資料夾、系統設定、瀏覽器搜尋與瀏覽器歷史。
• 輸入 ~\Desktop 然後按 Tab：只在桌面目錄內搜尋。
• 輸入 ? 再按空白或 Tab：切到 AI mode。
• 反白任意文字，連按兩次 Ctrl+C：開啟翻譯面板。

開發安裝

git clone https://github.com/aaaddress1/OpenClam.git
cd OpenClam
py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install --upgrade pip
.\.venv\Scripts\python.exe -m pip install -e .
openclam ui

模型與本機狀態

• 預設本機狀態目錄：.openclam/
• AI 模式預設模型：qwen2.5:0.5b
• 翻譯 backend：Meta NLLB + CTranslate2
• 若下載或初始化失敗，UI 會顯示可讀的錯誤訊息

隱私與資料

• .env、.openclam/、.venv/ 都不應納入版本控制。
• README 與預設設定不包含任何真實帳號、密碼、內網位址或個人路徑。
• 如果你要用遠端 API，請自行建立 .env 或設定 UI 內的 remote API 欄位。

開發與測試

py -3.12 -m unittest discover -s tests

---

OpenClam

Homepage: https://OpenClam.tw

OpenClam is a floating Windows AI launcher with local search, a clipboard translation panel, and lightweight on-device assistance.

Quick Install

winget install Python.Python.3.12
py -3.12 -m pip install --upgrade pip
py -3.12 -m pip install git+https://github.com/aaaddress1/OpenClam.git
openclam ui

On first launch, OpenClam automatically downloads the required local models:

• AI mode: qwen2.5:0.5b
• Translation panel: Meta lightweight translation model (meta-nllb via CTranslate2)

No Ollama installation is required.

Features

• Floating launcher bar for apps, files, folders, windows, browser history, system settings, and web actions.
• Scoped directory search: type a path such as ~\Downloads, press Tab, and search only inside that folder.
• AI mode: type ? then press Space or Tab to enter ClamAI Mode with the local qwen2.5:0.5b model.
• Clipboard translation panel: select text and press Ctrl+C twice to show a DeepL-style translation popup near the cursor.
• Right-side detail pane with metadata, actions, and file previews.
• Automatic model download and local caching under .openclam/.

Usage

Start the UI

openclam ui

Typical workflows

• Type any keyword for mixed search across apps, files, folders, settings, browser search, and browser history.
• Type ~\Desktop then press Tab to search only inside Desktop.
• Type ? and press Space or Tab to switch to AI mode.
• Select any text and press Ctrl+C twice to open the translation panel.

Development install

git clone https://github.com/aaaddress1/OpenClam.git
cd OpenClam
py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install --upgrade pip
.\.venv\Scripts\python.exe -m pip install -e .
openclam ui

Models and Local State

• Default local state directory: .openclam/
• Default AI model: qwen2.5:0.5b
• Translation backend: Meta NLLB + CTranslate2
• Download and initialization failures are surfaced in the UI with readable error messages

Privacy

• .env, .openclam/, and .venv/ must stay out of version control.
• The repository is sanitized and does not ship real personal credentials, internal network addresses, tunnel endpoints, or workstation-specific paths.
• If you want to use a remote API backend, create your own .env or configure it through the settings window.

Testing

py -3.12 -m unittest discover -s tests