This will also install the required dependencies: selenium, requests, websockets, and packaging.
2
Create your first script
Create a new Python file called test_undetected.py:
import undetected as uc# Create an undetected Chrome instancedriver = uc.Chrome()# Navigate to a websitedriver.get("https://example.com")# Print the page titleprint(driver.title)# Close the browserdriver.quit()
3
Run the script
Execute your script:
python test_undetected.py
On first run, Undetected will automatically download and patch the ChromeDriver binary matching your Chrome version. This may take a moment. The binary is cached for subsequent runs.
Let’s verify that Undetected successfully bypasses bot detection:
import undetected as ucdriver = uc.Chrome()# Visit a bot detection test sitedriver.get("https://bot.sannysoft.com")# The page should show you as undetected# (green checkmarks instead of red warning signs)input("Press Enter to close the browser...")driver.quit()
If the test site shows green checkmarks for most tests, your setup is working correctly. Some advanced detection methods may still identify automation, but common systems like CloudFlare should be bypassed.
import undetected as ucwith uc.Chrome() as driver: driver.get("https://example.com") print(driver.title) # Browser automatically closes when exiting the context
For running multiple browser instances in parallel:
import undetected as ucfrom undetected.patcher import Patcherimport multiprocessing as mpdef worker(idx: int): driver = uc.Chrome(user_multi_procs=True) driver.get("https://example.com") print(f"Worker {idx}: {driver.title}") driver.quit()if __name__ == "__main__": # Pre-patch ChromeDriver once before spawning processes Patcher.patch() # Create and start worker processes processes = [mp.Process(target=worker, args=(i,)) for i in range(4)] for p in processes: p.start() for p in processes: p.join()
When using multiprocessing, always call Patcher.patch() once in the main process before creating workers, and use user_multi_procs=True in worker processes.
