Documentation

Everything you need to know about OSIA

Installation

System Requirements

  • OS: Windows 10/11, Linux (Fedora, Ubuntu), macOS (coming soon)
  • Python: 3.12 or higher
  • RAM: 8GB minimum, 16GB recommended
  • Storage: 2GB free space
  • Network: Internet for cloud AI providers (optional for local models)

Windows

git clone https://github.com/mertioz/OSIA.git
cd OSIA

python -m venv venv
.\venv\Scripts\activate

pip install -r requirements.txt

.\start.bat

Linux

git clone https://github.com/mertioz/OSIA.git
cd OSIA

python -m venv venv
source venv/bin/activate

pip install -r requirements.txt

QT_QPA_PLATFORM=xcb python osia/main.py --wake

System Dependencies

  • ffmpeg — audio processing for STT/TTS
  • cloudflared — remote access tunnel
  • Playwright browsers — web automation
  • pywin32 (Windows) — native automation