Integuru v0
Generate Python integrations from browser network requests to internal platform APIs.
- Source repo
- Integuru-AI/Integuru
- Stars
- ★ 4.8k
- Last updated
- 5mo ago
- License
- AGPL-3.0
- Primary language
- Python
- FA score
- 41/100 · Major gaps
At a glance
- How it runs
- Works with
- Platform-specificOpenAI API
- Cost
- Free software; you pay for model usage
- Setup effort
- Medium · a few setup steps
- You'll need
- Typical use
- A developer automating utility-bill downloads can capture one browser download flow and have Integuru trace the account and user identifiers needed by the request.
- Not a fit if
- Users who cannot log into the target platform in a browser and complete 2FA
- Production teams needing official APIs or stable long-term integrations; this is an early public version
- Source review
- 41/100 · Major gaps 2 safety controls not found
What does this agent do, and when should you use it?
Integuru v0 is the publicly released early version of an integration agent that derives runnable code from browser network traffic. A user starts a browser with create_har.py, signs in, and performs the target action, producing request and cookie files. The integuru CLI then accepts a natural-language prompt and analyzes dynamic dependencies between captured requests. It can build a request dependency graph and generate Python code that executes the graph to perform the requested action. This version uses OpenAI cloud models, while the repository states that the newer Integuru version is available at integuru.com.
The user runs poetry run python create_har.py, logs into a destination platform in the spawned browser, and performs the desired action. The workflow creates network_requests.har and cookies.json, then runs poetry run integuru --prompt "download utility bills" --model <gpt-4o|o3-mini|o1|o1-mini>. Integuru identifies the target request, finds dynamic values such as accountId and userId, locates requests that provide those values, and attaches them into a dependency graph. It traverses from requests with no outgoing dependencies toward the target request and converts nodes into runnable functions. The CLI also exposes --har-path, --cookie-path, --max_steps, --input_variables, and --generate-code.
- A developer automating utility-bill downloads can capture one browser download flow and have Integuru trace the account and user identifiers needed by the request.
- An integration engineer working with a platform that lacks an official API can capture its browser traffic and generate Python calls to its internal endpoints.
- A developer who needs to break a browser action into dependent HTTP requests can use the generated graph to identify where dynamic request values originate.
- A developer exploring a graph that needs a value such as YEAR can supply key-value pairs through --input_variables.
- A maintainer validating the repository's behavior can run its documented test command, poetry run pytest.
How do you install or deploy this agent?
Use an OpenAI account and set the OPENAI_API_KEY environment variable. Install dependencies with poetry install, then enter the environment with poetry shell. For Jupyter use, run poetry run ipython kernel install --user --name=integuru. The documented CI workflow uses Python 3.12.
How do you use this agent?
Run poetry run python create_har.py, sign into the destination platform, and perform the target action to create ./network_requests.har and ./cookies.json. Then run poetry run integuru --prompt "download utility bills" --model gpt-4o. Use --har-path and --cookie-path for alternate input locations, and add --generate-code to request the full integration code. The repository recommends function-calling-capable gpt-4o for graph generation and says code generation automatically switches to o1-preview when that model is available in the user's OpenAI account.
What are this agent's strengths and limitations?
- Uses captured browser requests and traces upstream sources for dynamic values such as accountId and userId, instead of treating a single recorded request as sufficient.
- Produces a request dependency graph and can convert graph nodes into runnable Python functions and integration code.
- Provides documented CLI controls for custom HAR and cookie paths, maximum steps, graph input variables, and full-code generation.
- The repository states that captured data is stored locally in network_requests.har and cookies.json.
- This is the earliest publicly released version; the repository directs users to integuru.com for the newer version.
- A user must log into the target site and perform the action in a browser; for 2FA sites, they must complete 2FA and obtain the relevant session material.
- It requires an OpenAI API key and OpenAI cloud models including GPT-4o and o1-preview, with model availability dependent on the account.
- Input variables are documented as graph-generation-only; code-generation support for input variables is described as forthcoming.
How does this agent compare with similar options?
Key facts side by side with the most closely related agents.
| Agent | Source review | Form / cost | Stars | Updated | Language | Full support on |
|---|---|---|---|---|---|---|
| Integuru v0 This agent | 41 · Major gaps | CLIFree + model costs | ★ 4.8k | 5mo ago | Python | OpenAI API |
| Hello-Agents | 53 · Major gaps | Web appFree + model costs | ★ 86k | 25d ago | Python | OpenAI API |
| OpenEvolve | 51 · Major gaps | CLIFree + model costs | ★ 7.7k | 1d ago | Python | Claude Code · OpenAI API |
| Lagent Lightweight Agent Framework | 46 · Major gaps | Library / SDKFree + model costs | ★ 2.3k | 6mo ago | Python | OpenAI API |
How does FollowAgents rate this agent?
Why each dimension lost points
The evidence shows that the tool reads HAR and cookie files, supplies request information and cookies to a cloud LLM, and generates code that can call platform internal endpoints. Input files constrain the scope, but the materials show no collection minimization, pre-execution confirmation, secret redaction, or rollback mechanism, so most criteria lose points. The README mentions local storage and LLM use but does not explain whether request data is sent to the model or how credentials are handled. Dependencies have version ranges but no lockfile or security review evidence. The code and README attribute the product to Integuru v0; publisher identity and ongoing maintenance responsibility are unclear.
The README describes graph construction, code generation, and CLI options, and the main entry point broadly matches that workflow. However, the README gives a default max_steps of 20 while main.py uses 15, and the provided source shows no specific failure feedback for the optional --generate-code path. The dependency list and CI configuration provide limited availability evidence; CI only declares pytest, and the sampled tests use mocks, so static evidence cannot establish the real platform workflow.
The README targets users who want integration code for platforms without official APIs and explains browser capture, prompts, and input variable scenarios. The CLI supports model, file path, and step customization. Boundaries include input variables currently being supported only for graph generation and the requirement that users log in and complete 2FA first. There is no systematic account of platform compatibility, authorization prerequisites, or unsupported actions, so this does not receive full marks.
The README covers features, setup, usage, tests, CI, 2FA, and privacy, with a CLI example. Setup specifies a Python/Poetry environment, OpenAI API key, and model. The full AGPL-3.0 LICENSE supports full marks for licensing. The project is labeled v0, the package version is 0.1.0, and a newer version is mentioned on an external site, but no changelog is shown. A contact email and contribution invitation are present, while responsibility and the update path remain limited.
The product has a specific goal: infer a dependency graph from browser network requests and generate runnable Python request code. The README gives a utility bill example and workflow, supporting practical value for integrations without official APIs. The output can be used as code, but there is no evidence of generated-code security review, execution preview, action confirmation, or recovery. Model calls, browser capture, and credential preparation add setup cost, so the scores are moderate to low.
The README workflow and feature claims partly correspond to the CLI options, main entry point, and agent logic for URL and dynamic parameter identification. The privacy statement only mentions local files and a cloud LLM, without adequately explaining the data flow; the CI declaration cannot statically prove tests passed. The evidence distinguishes some documented facts from code behavior, but marketing claims, privacy details, and actual effectiveness lack corroboration across sources, so points are deducted.
- Not found in source: confirmation before actingTurn on (or add) a confirmation step before it acts, and try it in a sandbox or test environment before real data.
- Not found in source: rollback or recovery pathBack up first, or work on a git branch or snapshot, so its changes can be undone.
- The generated HAR and cookies.json may contain session credentials and personal data. The README does not clearly state whether this content is sent to the cloud model or how credentials are protected.
- Generated code calls platform internal endpoints and may perform the requested action. The materials show no human confirmation, permission review, or rollback process before execution.
FAQ
Is it intended for platforms without official APIs?
What credentials and files does it need?
Can it generate executable integration code?
Which models are documented?
Thanks — we use this to improve the page.