Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.finic.io/llms.txt

Use this file to discover all available pages before exploring further.

​
1. Clone repo

git clone https://github.com/finic-ai/finic.git

​
2. Run the test script locally to make sure it works.

It will open a local browser and navigate to this automation testing page, then fill out the form with hard-coded data. 
python testscript.py

​
3. Launch the Chrome container

sudo docker-compose up --build

​
4. Connect the test script to the container

Comment out this line:
testscript.py
browser = p.chromium.launch(headless=False, slow_mo=500)
and uncomment this line:
testscript.py
browser = p.chromium.connect_over_cdp("ws://localhost:8000/ws")
Then running the script again: 
python testscript.py
This is how you can toggle between local testing with a headful browser, to connecting your script to a deployed Chrome container in production. In reality you’ll probably want to deploy the Docker container to your cloud platform instead of running it on localhost.

​
Next Steps

You can now modify the test script however you want, or add Finic to an existing web automation project by using playwright.connect_over_cdp() or puppeteer.connect() 
from playwright.sync_api import sync_playwright

playwright = sync_playwright().start()
browser = playwright.chromium.connect_over_cdp("ws://browser.finic.io/?apikey=<your-finic-api-key>")    
page = browser.new_page()
await page.goto("https://github.com/finic-ai/finic")