VibeMouse
Mouse-side-button voice input for VibeCoding on Linux.
File Explorer
Download Latest Version (.zip)- button-map.jpg
- cover.jpg
- index.md
- cover.jpg
- index.md
- cover.jpg
- index.md
- config.yml
- ci.yml
- AI_ASSISTANT_DEPLOYMENT.md
- AI_ASSISTANT_DEPLOYMENT.zh-CN.md
- AI_DEBUG_RUNBOOK.md
- assistant-key-detector.html
- STEP1_PR_SPLIT_PLAN.zh-CN.md
- TWO_STEP_MIGRATION_PLAN.md
- TWO_STEP_MIGRATION_PLAN.zh-CN.md
- auto-deploy.sh
- qwen3_ov_npu_bounds.py
- config.example.json
- COMMANDS.md
- EVENTS.md
- config.schema.json
- ipc.schema.json
- status.schema.json
- test_resolver.py
- test_main.py
- test_app.py
- test_audio.py
- test_output.py
- __init__.py
- test_client_server.py
- test_messages.py
- test_keyboard_listener.py
- test_mouse_listener.py
- test_deploy.py
- test_doctor.py
- test_system_integration.py
- test_config.py
- test_config_store.py
- __init__.py
- actions.py
- resolver.py
- __init__.py
- listener_cli.py
- main.py
- __init__.py
- env_overrides.py
- migration.py
- schema.py
- store.py
- __init__.py
- app.py
- audio.py
- commands.py
- logging_setup.py
- output.py
- transcriber.py
- __init__.py
- client.py
- messages.py
- server.py
- __init__.py
- keyboard_listener.py
- mouse_listener.py
- __init__.py
- deploy.py
- doctor.py
- __init__.py
- system_integration.py
- __init__.py
- app.py
- audio.py
- deploy.py
- doctor.py
- keyboard_listener.py
- logging_setup.py
- main.py
- mouse_listener.py
- output.py
- system_integration.py
- transcriber.py
- .gitignore
- LICENSE
- pyproject.toml
- README.md
- README.zh-CN.md
- THIRD_PARTY_NOTICES.md
# Installation Guide
1. Get the code
git clone https://github.com/vimalinx/VibeMouse
Downloads the entire project code from GitHub to your computer.
cd VibeMouse
Moves into the project folder you just downloaded.
2. Official Install Script
Easy RecommendedPrerequisites
- APT (Debian/Ubuntu κ³μ΄) Built into Debian/Ubuntu-based Linux distributions.
- Python 3 Python is required to use pip.
sudo apt install -y python3-gi gir1.2-atspi-2.0 portaudio19-dev libsndfile1
Installs directly from the APT package repository (Debian/Ubuntu-based).
pip install -U pip
Installs the package published on PyPI directly β no need to clone the source.
After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.
Pulled directly from this repo's README.
3. Python
EasyPrerequisites
sudo pacman -Syu --needed python python-pip python-gobject portaudio libsndfile
Runs the Python script (or module).
python3 -m venv .venv
Runs the Python script (or module).
pip install -U pip
Installs the package published on PyPI directly β no need to clone the source.
pip install -e .
Installs the Python libraries listed in requirements.txt (or similar).
If it runs without errors and prints output in the terminal, it worked.
Pulled directly from this repo's README.
// repository documentation
Was this content helpful?
(0 ratings)