{"_id":"gemini-computer-use","name":"gemini-computer-use","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.2":{"name":"gemini-computer-use","version":"0.1.2","description":"Turn your PC, Laptop, or Server into an autonomous execution node for Google Gemini via Native MCP","main":"bin/cli.js","bin":{"gemini-computer-use":"bin/cli.js"},"scripts":{"start":"node ./bin/cli.js"},"keywords":["gemini","mcp","computer-use","model-context-protocol","ai","automation","google-gemini","spark"],"author":{"name":"LevRa7"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/LevRa7/Computer-use-for-Gemini-App-Web.git"},"bugs":{"url":"https://github.com/LevRa7/Computer-use-for-Gemini-App-Web/issues"},"homepage":"https://github.com/LevRa7/Computer-use-for-Gemini-App-Web#readme","_id":"gemini-computer-use@0.1.2","gitHead":"e84401540c5a96880bdaecfeacb217b77ada00b8","_nodeVersion":"22.19.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-CIvqNfwR0x68+a9+bK2u7SiM3HkUgc4kUxoo7EjPG1H4z0dRQ+BZkxRlKq5RyYQBIAF1Scv6xNTpII4bK3Xcaw==","shasum":"5a26b16325e323581f2a7482ee3f48f28f94ffed","tarball":"https://registry.npmjs.org/gemini-computer-use/-/gemini-computer-use-0.1.2.tgz","fileCount":18,"unpackedSize":91333,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHnGhnxDoHqXqLMU7hTj8P0V0bLrQddQXt9dcjmgerVpAiBJ++pOuf8GhkNAeF2Fzt48gDX2Q5bVvwiqoY1v4MSXIw=="}]},"_npmUser":{"name":"levra","email":"Levra772@gmail.com"},"directories":{},"maintainers":[{"name":"levra","email":"Levra772@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/gemini-computer-use_0.1.2_1789995263926_0.4644187269487703"},"_hasShrinkwrap":false}},"time":{"created":"2026-09-21T12:54:23.691Z","0.1.2":"2026-09-21T12:54:24.069Z","modified":"2026-09-21T12:54:24.324Z"},"maintainers":[{"name":"levra","email":"Levra772@gmail.com"}],"description":"Turn your PC, Laptop, or Server into an autonomous execution node for Google Gemini via Native MCP","homepage":"https://github.com/LevRa7/Computer-use-for-Gemini-App-Web#readme","keywords":["gemini","mcp","computer-use","model-context-protocol","ai","automation","google-gemini","spark"],"repository":{"type":"git","url":"git+https://github.com/LevRa7/Computer-use-for-Gemini-App-Web.git"},"author":{"name":"LevRa7"},"bugs":{"url":"https://github.com/LevRa7/Computer-use-for-Gemini-App-Web/issues"},"license":"MIT","readme":"# 🚀 Gemini Computer Use (Web & Mobile App) — FREE & Open Source\n\n> **Turn your PC, Laptop, or Server into an autonomous execution node for Google Gemini (Web & Mobile App) via Native Model Context Protocol (MCP).**\n\n[English](README.md) | [🇷🇺 Русская версия](#-русская-версия)\n\n---\n\n## 💡 What is Gemini Computer Use?\n\n**Gemini Computer Use** is an open-source, free solution that gives **Google Gemini** direct, autonomous command-execution capability on your local machine, laptop, or remote cloud server directly from the chat interface of [gemini.google.com](https://gemini.google.com), the official Gemini mobile app, or Google AI Studio.\n\nUnlike proprietary paid alternatives, this project uses the official open **Model Context Protocol (MCP)** specification from Google. It operates over a secure, outbound WebSocket reverse tunnel (no open router ports or public IPs required) or in a pure local standalone mode.\n\n---\n\n## ✨ Key Features\n\n- 🆓 **100% Free**: Operates directly with the free tier of Google Gemini (Web & Mobile app).\n- ⚡ **Zero-Config One-Line Install**: Auto-detects device type (laptop, desktop, VPS, container), OS, and architecture.\n- 🌐 **Two Deployment Modes**:\n  1. **Cloud Gateway + Reverse Tunnel (Recommended)**: Works behind NAT, firewalls, and dynamic IPs. No inbound ports required.\n  2. **Local Standalone**: Pure localhost FastMCP server on `localhost:8096` with zero external dependencies.\n- 🛡️ **Cryptographic Token Security**: Every tool invocation is secured by a 128-bit secret token (`?token=...`). Unauthorized requests are strictly blocked with HTTP 401.\n- 📡 **Remote SSH Deployment**: Deploy nodes to remote Linux servers in one command directly from your terminal (`--ssh=user@host`).\n- 🔄 **Native Background Autostart**: Installs and enables system background services (`systemd` on Linux, `launchd` on macOS, background task on Windows).\n- 📱 **Mobile & Web Ready**: Prompt Gemini from your smartphone on the go — your home laptop or cloud server will execute tasks in real time!\n- 💻 **Cross-Platform**: Fully supports Linux, macOS, and Windows.\n\n---\n\n## 🛠️ Available MCP Tools\n\nOnce connected, Google Gemini gains direct native access to:\n- `bash_exec(command)`: Execute shell commands, build code, run test suites, manage git repositories.\n- `system_vitals()`: Real-time telemetry monitoring: CPU load, RAM usage, and disk space.\n- `get_orchestration_skill()`: Dynamic delivery of infrastructure orchestrator personas and operational guidelines.\n\n---\n\n## 🚀 Quick Start (One-Liner Install)\n\n### 🐧 Linux & 🍎 macOS (via curl)\n```bash\ncurl -fsSL https://smart-server.online/install.sh | bash\n```\n\n### 🪟 Windows (via PowerShell)\n```powershell\nirm https://smart-server.online/install.ps1 | iex\n```\n\n### 📦 Node.js / NPM (Cross-platform)\n```bash\nnpx gemini-computer-use\n```\n\n### 🛠️ Or clone via Git\n```bash\ngit clone https://github.com/LevRa7/Computer-use-for-Gemini-App-Web.git\ncd Computer-use-for-Gemini-App-Web\n./install.sh --quick\n```\n\n---\n\n## 📱 Connecting to Google Gemini\n\n1. Open **[gemini.google.com/spark/apps](https://gemini.google.com/spark/apps)** (or the Gemini mobile app).\n2. Click **Add App** (or go to **Settings ⚙️ ➔ Tools / Extensions (MCP)**).\n3. The MCP SSE URL is **automatically copied to your clipboard** during install — just paste it (**Ctrl+V**):\n   ```text\n   https://<your-device-name>.smart-server.online/sse?token=<your_secret_token>\n   ```\n4. Done! You can now prompt Gemini:\n   - *\"Check system resources using system_vitals\"*\n   - *\"Create a FastAPI application and run test coverage via bash_exec\"*\n   - *\"Git commit and push changes\"*\n\n---\n\n## 🖥️ Deployment Modes\n\n### Mode 1: Cloud Gateway + Tunnel (Recommended)\n```bash\n./install.sh --quick\n```\nPerfect for personal laptops and home workstations behind NAT. The connection is maintained via an outbound secure WebSocket tunnel.\n\n### Mode 2: Local Standalone\n```bash\n./install.sh --mode=standalone --port=8096\n```\nRuns an isolated, local FastMCP server on `http://localhost:8096/sse` without cloud relaying.\n\n### Mode 3: Remote SSH Install\n```bash\n./install.sh --ssh=user@my-remote-server.com\n```\nAutomatically transfers files and configures the node on your remote server via SSH.\n\n---\n\n## 🔒 Security Architecture\n\n- **Token-Gated Endpoints**: Every incoming request must contain the cryptographic token via `?token=...` or `Authorization: Bearer`.\n- **Outbound-Only Tunnel**: Local nodes do not open listening public ports. The agent initiates an outbound WebSocket connection to the gateway.\n- **Unprivileged Execution**: Agents execute in user-space by default without requiring root privileges.\n\n---\n\n## 📄 License\n\nThis project is licensed under the **MIT License**. See [LICENSE](LICENSE) for details.\n\n---\n---\n\n# 🇷🇺 Русская версия\n\n> **Превратите свой ПК, ноутбук или сервер в автономный исполнительный узел для Google Gemini (Web и Mobile App) через нативный протокол Model Context Protocol (MCP).**\n\n---\n\n## 💡 Что это такое?\n\n**Gemini Computer Use** — это открытое и бесплатное решение для прямого управления вашим компьютером, ноутбуком или удалённым сервером из диалогового окна **Google Gemini** (включая веб-версию [gemini.google.com](https://gemini.google.com), мобильное приложение Gemini и Google AI Studio).\n\nПроект использует официальный протокол **Model Context Protocol (MCP)** от Google и работает поверх защищённого WebSocket-туннеля или в локальном автономном режиме.\n\n---\n\n## ✨ Ключевые возможности\n\n- 🆓 **100% Бесплатно**: Работает со стандартным бесплатным тарифом Google Gemini (Web и Mobile App).\n- ⚡ **Установка в одну команду (One-Line Setup)**: Скрипт автоматически определяет тип устройства (ноутбук/десктоп/VPS/сервер), ОС и архитектуру.\n- 🌐 **Два режима работы**:\n  1. **Cloud Gateway + Reverse Tunnel**: Работает из-за любого «серого» IP, роутера и NAT без белого IP и проброса портов.\n  2. **Local Standalone**: Полностью локальный FastMCP-сервер на `localhost:8096` без внешних зависимостей.\n- 🛡️ **Строгая безопасность**: Каждый запрос к инструментам защищён персональным криптографическим токеном (`?token=...`). Доступ посторонних строго отсекается (HTTP 401).\n- 📡 **Удалённая установка через SSH**: Развёртывание узла на удалённом сервере одной командой (`--ssh=user@host`).\n- 🔄 **Автозапуск**: Интеграция со службами автозапуска (`systemd` в Linux, `launchd` в macOS, автозапуск в Windows).\n- 📱 **Управление со смартфона**: Пишите команды в мобильном приложении Gemini — ваша домашняя машина выполнит их в реальном времени!\n- 💻 **Кроссплатформенность**: Полная поддержка Linux, macOS и Windows.\n\n---\n\n## 🛠️ Доступные MCP-инструменты\n\n- `bash_exec(command)` — автономное выполнение команд терминала, компиляция кода, тесты, git-операции.\n- `system_vitals()` — мониторинг нагрузки в реальном времени (CPU, RAM, диск).\n- `get_orchestration_skill()` — системные правила и скилл автономного оркестратора инфраструктуры.\n\n---\n\n## 🚀 Быстрый старт (Установка в 1 команду)\n\n#### 🐧 Linux & 🍎 macOS (через curl):\n```bash\ncurl -fsSL https://smart-server.online/install.sh | bash\n```\n\n#### 🪟 Windows (через PowerShell):\n```powershell\nirm https://smart-server.online/install.ps1 | iex\n```\n\n#### 📦 Node.js / NPM (Кроссплатформенно):\n```bash\nnpx gemini-computer-use\n```\n\n#### 🛠️ Либо вручную через Git:\n```bash\ngit clone https://github.com/LevRa7/Computer-use-for-Gemini-App-Web.git\ncd Computer-use-for-Gemini-App-Web\n./install.sh --quick\n```\n\n---\n\n## 📱 Подключение к Google Gemini\n\n1. Откройте страницу **[gemini.google.com/spark/apps](https://gemini.google.com/spark/apps)** (в браузере или приложении).\n2. Нажмите **Добавить приложение** (Add App / Настройки ➔ MCP).\n3. Ссылка на ваш MCP-сервер **автоматически скопирована в буфер обмена** при установке — просто вставьте её (**Ctrl+V**):\n   ```text\n   https://<имя-вашего-пк>.smart-server.online/sse?token=<ваш_секретный_токен>\n   ```\n4. Готово! Теперь Gemini может выполнять команды прямо на вашей машине.\n\n---\n\n## 📄 Лицензия\n\nРаспространяется под свободной лицензией **MIT**. Подробности в файле [LICENSE](LICENSE).\n","readmeFilename":"README.md","_rev":"1-aead6e3b43457c97ee26346aaed8d979"}