v16.ai
v0.2.15
Published
V16 - General AI Agent. Full desktop control - mouse, keyboard, screen capture, and more. Let AI control your computer.
Maintainers
Readme
V16 - General AI Agent
AI that actually does things
V16 connects your local machine to a powerful AI agent that can control your entire computer - mouse, keyboard, screen capture, browser automation, code execution, and more.
Installation
npm install -g v16.aiThis will also install Python dependencies for desktop control.
Quick Start
Sign up at v16.ai
Get your token from v16.ai/settings
Connect your machine:
v16 connect --token YOUR_TOKENStart using V16 - Go to the dashboard and tell the agent what to do
What V16 Can Do
Desktop Control (NEW)
Full control over your computer:
- Screen Capture - Take screenshots of your entire screen
- Mouse Control - Move, click, drag, scroll anywhere
- Keyboard Control - Type text, press keys, hotkeys (Cmd+C, etc.)
- Window Management - List windows, focus apps, get window bounds
- Clipboard - Read and write clipboard content
Execute Code
- Run shell commands and scripts
- Install packages and dependencies
- Build and deploy projects
- Execute Python, Node.js, and more
Manage Files
- Read and write files
- Create and organize directories
- Search and modify content
Automate Browsers
- Open websites and navigate
- Fill forms and click buttons
- Take screenshots
- Scrape data
Example Tasks
- "Open Chrome and go to twitter.com"
- "Take a screenshot and describe what you see"
- "Click the login button and enter my credentials"
- "Open VS Code and create a new file"
- "Build me a REST API and test it"
Commands
v16 connect # Connect to V16
v16 connect --token XXX # Connect with specific token
v16 test # Test all capabilities (CLI, browser, desktop)
v16 login # Get token instructions
v16 --help # Show all commandsDesktop Control Capabilities
| Command | Description |
|---------|-------------|
| screenshot | Capture full screen |
| mouse-move | Move cursor to x,y coordinates |
| mouse-click | Click at position |
| mouse-double-click | Double click |
| mouse-right-click | Right click |
| mouse-drag | Drag from point A to B |
| mouse-scroll | Scroll up/down |
| keyboard-type | Type text |
| keyboard-press | Press single key (Enter, Escape, etc.) |
| keyboard-hotkey | Key combo (Cmd+C, Ctrl+V, etc.) |
| clipboard-read | Read clipboard content |
| clipboard-write | Write to clipboard |
| window-list | List all open windows |
| window-focus | Focus/activate an app |
Requirements
- Node.js 18+
- Python 3.8+ with pip
- macOS, Windows, or Linux
Python Dependencies (auto-installed)
- pyautogui - Mouse and keyboard control
- mss - Fast screen capture
- pyperclip - Clipboard access
- Pillow - Image processing
macOS Permissions
On macOS, you need to grant accessibility permissions:
- Go to System Preferences → Security & Privacy → Privacy
- Select "Accessibility" from the left sidebar
- Add Terminal (or your terminal app) to the list
Environment Variables
| Variable | Description |
|----------|-------------|
| V16_TOKEN | Your authentication token |
| V16_SERVER | Custom server URL (default: https://api.v16.ai) |
Security
- All communication is encrypted (HTTPS/WSS)
- Only authenticated commands from your V16 account are executed
- You control what the agent can access
- Disconnect anytime with
v16 logout
Note: The agent has full control over your computer. Only connect machines you trust.
Links
- Website: v16.ai
- Discord: discord.gg/AnBesyRQ4F
- Issues: github.com/v16ai/v16/issues
License
MIT
