Azul Browse

A beautiful terminal web browser with AI-powered chat, built in Rust.

Features

• Full TUI web browsing with keyboard navigation
• AI chat panel with tool-calling support (navigate, scroll, follow links)
• Multi-engine search (DuckDuckGo, Wikipedia, arXiv, PubMed, Google Scholar, OpenLibrary)
• JavaScript rendering via headless Chrome
• Bookmarks and history
• Cosmic dark theme
• Tab support
• RAG integration (optional)

Prerequisites

• Rust (1.70+): https://rustup.rs/
• Chrome/Chromium (optional): Required for --js mode (JavaScript rendering)

Installation

From Releases (Recommended)

Download the latest binary for your platform from Releases:

# Linux (x86_64)
curl -LO https://github.com/0xSero/Azul/releases/latest/download/azul-linux-x86_64.tar.gz
tar xzf azul-linux-x86_64.tar.gz
sudo mv azul /usr/local/bin/

# macOS (Apple Silicon)
curl -LO https://github.com/0xSero/Azul/releases/latest/download/azul-darwin-aarch64.tar.gz
tar xzf azul-darwin-aarch64.tar.gz
sudo mv azul /usr/local/bin/

# macOS (Intel)
curl -LO https://github.com/0xSero/Azul/releases/latest/download/azul-darwin-x86_64.tar.gz
tar xzf azul-darwin-x86_64.tar.gz
sudo mv azul /usr/local/bin/

From Source

# Clone the repo
git clone https://github.com/0xSero/Azul.git
cd Azul

# Quick install (uses Makefile)
make install          # System-wide (/usr/local/bin, requires sudo)
make install-user     # User-only (~/.local/bin)

# Or manually
cargo build --release
./target/release/azul

# Or via cargo
cargo install --path .

Quick Start

# Start TUI browser
azul

# Search DuckDuckGo
azul -q "rust programming"

# Search Wikipedia
azul -q "w:Rust language"

# Fetch a URL directly
azul -q "https://example.com"

# Fetch with JavaScript rendering
azul --js -q "https://example.com"

Configuration

Config file location: ~/.config/azul/config.json

{
  "theme": {
    "accent": "#00BFFF",
    "border": "#7aa2f7",
    "text": "#c0caf5",
    "background": "#1a1b26"
  },
  "ai": {
    "provider": "openrouter",
    "api_key": "YOUR_API_KEY",
    "model": "anthropic/claude-3.5-sonnet",
    "base_url": "https://openrouter.ai/api/v1"
  },
  "refresh_rate_ms": 200,
  "rag_base_url": "http://127.0.0.1:3002",
  "memory_scope": "azul-browse"
}

AI Providers

The browser supports OpenAI-compatible APIs:

Keybindings

Global

Content Navigation

Chat Panel

URL Bar

Search Prefixes

No prefix defaults to DuckDuckGo. URLs (containing .) go directly to the site.

AI Chat

The chat panel supports tool calls - the AI can: - Navigate to URLs - Follow links by number - Scroll the page

Example prompts: - "Go to wikipedia.org" - "Click on the first link" - "Scroll down to see more" - "Summarize this page"

Development

# Build debug
make build            # or: cargo build

# Run with logging
RUST_LOG=debug cargo run

# Run all checks (format, lint, test)
make check

# Individual checks
make test             # Run tests
make lint             # Run clippy
make fmt              # Format code
make fmt-check        # Check formatting

# Clean build artifacts
make clean

Releasing

Releases are automated via GitHub Actions. To create a new release:

# 1. Update version (choose one)
make bump-patch       # 0.0.7 -> 0.0.8
make bump-minor       # 0.0.7 -> 0.1.0
make bump-major       # 0.0.7 -> 1.0.0

# 2. Update CHANGELOG.md with changes

# 3. Commit changes
git add -A
git commit -m "chore: bump version to $(make version)"

# 4. Create and push tag (triggers release build)
make release-tag

The GitHub Action will automatically: - Build binaries for Linux (x86_64, musl) and macOS (x86_64, ARM64) - Create a GitHub Release with the binaries - Generate SHA256 checksums

Project Structure

src/
├── main.rs          # Entry point, CLI/TUI setup
├── app.rs           # Application state and input handling
├── browser/         # HTTP fetching, page parsing
├── chat/            # Chat session management
├── config.rs        # Configuration loading
├── ai/              # AI provider integration
├── ui/              # Ratatui UI rendering
├── search/          # Multi-engine search
├── storage/         # SQLite bookmarks/history
├── tabs/            # Tab management
├── rag/             # RAG integration
└── memory/          # Memory/context persistence

License

MIT