Skip to content

getting-started-python.md

Latest commit

 

History

History
214 lines (147 loc) · 4.08 KB

getting-started-python.md

File metadata and controls

214 lines (147 loc) · 4.08 KB

Getting Started with Vibium (Python)

A complete beginner's guide. No prior experience required.

What You'll Build

A script that opens a browser, visits a website, takes a screenshot, and clicks a link. All in about 10 lines of code.

Step 1: Install Python

Vibium requires Python 3.9 or higher. Check if you have it:

python3 --version

If you see a version number (like Python 3.9.0 or higher), skip to Step 2.

macOS

# Install Homebrew (if you don't have it)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Python
brew install python

Windows

Download and run the installer from python.org. Choose the latest version.

Linux

# Ubuntu/Debian
sudo apt-get install python3 python3-pip python3-venv

# Or use your distro's package manager

Step 2: Create a Project Folder

mkdir my-first-bot
cd my-first-bot
python3 -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

Step 3: Install Vibium

pip install vibium

This downloads Vibium and the vibium binary for your platform.

Optionally, pre-download Chrome:

vibium install

Or just let it download automatically on first run.

Step 4: Write Your First Script

Create a file called hello.py:

from vibium import browser_sync as browser

# Launch a browser (you'll see it open!)
vibe = browser.launch()

# Go to a website
vibe.go("https://example.com")
print("Loaded example.com")

# Take a screenshot
png = vibe.screenshot()
with open("screenshot.png", "wb") as f:
    f.write(png)
print("Saved screenshot.png")

# Find and click the link
link = vibe.find("a")
print("Found link:", link.text())
link.click()
print("Clicked!")

# Close the browser
vibe.quit()
print("Done!")

Step 5: Run It

python3 hello.py

You should see:

  1. A Chrome window open
  2. example.com load
  3. The browser click "More information..."
  4. The browser close

Check your folder - there's now a screenshot.png file!

What Just Happened?

Line What It Does
browser.launch() Opens Chrome
vibe.go(url) Navigates to a URL
vibe.screenshot() Captures the page as PNG bytes
vibe.find(selector) Finds an element by CSS selector
link.text() Gets the element's text content
link.click() Clicks the element
vibe.quit() Closes the browser

Next Steps

Hide the browser (run headless):

vibe = browser.launch(headless=True)

Use async/await (for more complex scripts):

import asyncio
from vibium import browser

async def main():
    vibe = await browser.launch()
    await vibe.go("https://example.com")
    # ...
    await vibe.quit()

asyncio.run(main())

Use JavaScript instead: See Getting Started (JavaScript) for the JS version.

Add to Claude Code (let AI control the browser):

claude mcp add vibium -- npx -y vibium mcp

See Getting Started with MCP for the full guide.

Troubleshooting

"command not found: python3"

Python isn't installed or isn't in your PATH. Reinstall from python.org.

"No module named 'vibium'"

Make sure you activated the virtual environment:

source .venv/bin/activate

Then install vibium:

pip install vibium

Browser doesn't open

Try running with headless mode disabled (it's disabled by default, but just in case):

vibe = browser.launch(headless=False)

Permission denied (Linux)

You might need to install dependencies for Chrome:

sudo apt-get install -y libgbm1 libnss3 libatk-bridge2.0-0 libdrm2 libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libasound2

You Did It!

You just automated a browser with Python. The same techniques work for:

  • Web scraping
  • Testing websites
  • Automating repetitive tasks
  • Building AI agents that can browse the web

Questions? Open an issue.