Aluvia

Global proxy IPs for AI agents.

Aluvia lets agents change their IP address using a global network of residential IPs.

Copy-paste to any agent.

Agents can run setup themselves.

No account, API key, or payment is required during the free trial. See docs.

  • Grok Bot
  • Codex
  • Claude
  • OpenClaw
  • Hermes

Access geo-blocked content

Give agent an IP from a different country.

ChromeIllustration
store.example/de/products

When a cloud agent opens a website, the site sees the datacenter's country. That can return the wrong prices or catalog, or a page that says the content is unavailable in that region.

Aluvia lets the agent use a residential or mobile IP in the country the task requires. Run aluvia proxy-on --geo US, then reload the page to check the result. Replace US with the country you need; aluvia geos lists available countries.

See country selection and setup

Use residential IPs instead of the agent's datacenter IP

Agents in the cloud use datacenter IPs that often get blocked.

ChromeIllustration
store.example/products

Aluvia routes the agent's existing browser through a residential or mobile IP. If a site is blocking the datacenter IP, changing the IP can help the agent continue.

A different IP sometimes clears a 403, CAPTCHA, or Cloudflare challenge. It does not resolve every block; browser checks and login requirements can still apply.

Bypass blocked pages · Guides

How it works

Install Aluvia on agent's machine

Run this on the machine where the agent's Chrome or Chromium browser runs. Requires Node.js 18 or later and a usable local browser. No target page URL is required. Initial browser configuration can restart Chrome. What setup changes

Setup installs the command launcher and agent skill, starts the local proxy, configures the browser, and enables proxy traffic. Check the JSON result: ready: true means the browser reached the local proxy and the upstream connection check passed. If setup cannot finish, follow next to recover. Then choose a country or your own proxy below.

Use Aluvia's proxy IPs

Choose a country from Aluvia's global residential and mobile IP network, then reload the page. The same IP is reused for up to 30 minutes. First 10 MB free, then $2/GB.

Aluvia proxy
$ aluvia proxy-on --geo US

Or

Use your own proxy IPs

Already have an HTTP or HTTPS proxy? Give the agent your proxy URL. Aluvia connects the browser to it. You do not pay Aluvia for that bandwidth.

Your proxy
$ aluvia proxy-provider PROXY_URL

CLI commands

Every command prints JSON on stdout with a next field. Read next and run it. Never print API keys. If aluvia is not on the PATH, replace aluvia with npx aluvia-cli.

Aluvia CLI commands
aluvia setupConfigure the browser and enable proxy traffic. Repeat to check a working setup without restarting the browser or changing its live proxy session.
aluvia proxy-onSend every tab through Aluvia, then reload the page.
aluvia proxy-on --geo USUse an IP in a specific country. Omit --geo for the global pool. Run aluvia geos for the list.
aluvia proxy-offGo back to the machine's own IP. The browser keeps running.
aluvia rotate-ipGet a new exit IP when the current one is still blocked.

The full table, including the commands an agent needs and a human rarely does, is in llms.txt.

FAQs

How do I start the free trial?
Ask your agent to run npx aluvia-cli setup on the machine where its Chrome or Chromium browser runs. No target page URL is required. Setup needs Node.js 18 or later and a usable local browser runtime. Initial configuration can restart Chrome. Check the JSON result and follow next if recovery is needed. The first 10 MB is free. No account, API key, or payment is required.
What happens when the free data runs out?
The CLI gives you a link to claim the account and buy data. Aluvia network traffic costs $2/GB after the free trial. You choose whether to continue.
Can I use my own proxy?
Yes. Run aluvia proxy-provider PROXY_URL with an HTTP or HTTPS proxy URL you already have. You do not pay Aluvia for that bandwidth. To switch back, run aluvia proxy-provider aluvia.
Which countries can I use?
Run aluvia geos to see the countries available on Aluvia's global residential and mobile IP network. Use aluvia proxy-on --geo US to choose a country. Omit --geo to use the global pool. Country only, not city. Sticky sessions last up to 30 minutes. With your own proxy, the location depends on your provider.
Will I lose my open tabs or cookies?
Initial browser configuration can restart Chrome. Save unfinished work first; state preservation is not guaranteed across every platform or automation runtime. Running setup again on a working setup checks the connection and enables proxy traffic without restarting the browser or changing the live proxy session. After setup, aluvia proxy-on, aluvia proxy-off, and aluvia rotate-ip keep Chrome running with its open tabs and cookies.
Will a different IP solve every block?
No. A residential or mobile IP in the right country sometimes clears a block associated with the current IP. Aluvia does not claim to change browser fingerprint, TLS, canvas, GPS, timezone, or Accept-Language, and it is not for a normal login wall.