The Narada Python SDK can automatically record your automation workflow as an animated GIF, providing visual documentation of each step. This is invaluable for debugging, compliance reporting, and understanding automation behavior.

​
Recording GIFs with the SDK

import asyncio
from narada import Narada

async def main() -> None:
    async with Narada() as narada:
        window = await narada.open_and_initialize_browser_window()

        # Run automation with GIF recording enabled
        response = await window.agent(
            prompt='search for "machine learning" on Google and extract the number of results',
            generate_gif=True  # Enable GIF recording
        )

        print("Response:", response.text)
        print("GIF saved to your Downloads/Narada Downloads folder!")

if __name__ == "__main__":
    asyncio.run(main())
The SDK automatically compiles frames into an animated GIF showing the complete automation trajectory.
1

Automatic Directory Creation

Narada automatically creates a directory structure for your GIFs:
  1. Main Directory: Narada Downloads in your machine’s Downloads folder
  2. Request Directory: Directory named after your request_id from the SDK response
  3. File: Automation saved as an animated .gif file
If the Narada Downloads directory doesn’t exist, it will be created automatically.
2

Find Your GIF File

Navigate to your Downloads folder and look for:
Downloads/
└── Narada Downloads/
    └── req_abc123def456/
        └── automation_recording.gif
Each GIF request gets its own directory named after the request_id for easy correlation with your SDK calls.

​
GIF Features

​
Best Practices

Debugging

Record GIFs when testing new automation workflows

Documentation

Save GIFs to document complex automation steps

Compliance

Keep GIFs as proof of automation execution

Training

Use GIFs to train team members on automation flows