CNPq/Lattes Navigator - Browser-Use Tool for COI Detection

.gitignore

@@ -1,3 +1,2 @@
 .venv/
-.webui_secret_key
-datasets/
+.webui_secret_key

.python-version

@@ -0,0 +1 @@
+3.11.8

agents4gov/.gitignore

@@ -0,0 +1,3 @@
+.venv/
+.webui_secret_key
+datasets/

agents4gov/README.md

@@ -0,0 +1,91 @@
+
+# Agents4Gov
+
+**Laboratory of Computational Intelligence (LABIC – ICMC/USP)**
+
+
+## Overview
+
+**Agents4Gov** is a research and development project from **LABIC – Institute of Mathematics and Computer Sciences (ICMC/USP)** focused on building **LLM-based tools** to support and modernize **public sector services**.
+The project emphasizes **local Large Language Models (LLMs)** for privacy, **data anonymization**, and the **development and evaluation of tools** for use in government and institutional environments.
+
+---
+
+## Installation
+
+### 1. Install the Open WebUI Server
+
+Agents4Gov is built on top of the **[Open WebUI](https://github.com/open-webui/open-webui)** framework, which serves as the base environment for loading and running tools.
+
+Before starting, ensure you are using **Python 3.11** to avoid compatibility issues.
+
+To install and run Open WebUI:
+
+```bash
+# Install Open WebUI
+pip install open-webui
+
+# Start the server
+open-webui serve
+```
+
+After starting, the Open WebUI interface will be available at:
+👉 **[http://localhost:8080](http://localhost:8080)**
+
+---
+
+### 2. Clone the Agents4Gov Repository
+
+In the same environment, clone the Agents4Gov repository:
+
+```bash
+git clone https://github.com/icmc-usp/Agents4Gov.git
+```
+
+The `tools/` directory inside the repository contains all implemented tools.
+
+---
+
+### 3. Import Tools into Open WebUI
+
+Once Open WebUI is running:
+
+1. Access the **Tools** module in the Open WebUI interface.
+2. Use the **Import Tool** option to add any of the tools from the `Agents4Gov/tools/` directory.
+3. Each tool has its own documentation and configuration guide within its folder.
+
+Example:
+
+```bash
+ls Agents4Gov/tools/
+```
+
+Each subdirectory corresponds to an individual tool that can be imported, executed, and evaluated directly within Open WebUI.
+
+---
+
+## Repository Structure
+
+```
+Agents4Gov/
+├── tools/                 # Implemented tools for public services
+├── data/                  # Example or anonymized datasets
+├── docs/                  # Documentation and evaluation reports
+├── config/                # Model and system configuration files
+└── README.md
+```
+
+---
+
+## Objectives
+
+* Develop and evaluate **LLM-based tools** focused on **public sector innovation**.
+* Ensure **privacy-preserving** AI development using local LLMs and anonymized data.
+* Provide a **modular and extensible** framework for integrating intelligent tools into public service environments.
+
+---
+
+## License
+
+This project is licensed under the **MIT License**.
+See the [LICENSE](LICENSE) file for details.

agents4gov/config/README.md

@@ -0,0 +1 @@
+

agents4gov/data/README.md

@@ -0,0 +1 @@
+

agents4gov/docs/README.md

@@ -0,0 +1,52 @@
+# Agents4Gov Documentation
+
+Welcome to the Agents4Gov documentation. This directory contains guides and tutorials to help you work with the framework.
+
+## Project Structure
+
+Agents4Gov is built on top of **[Open WebUI](https://github.com/open-webui/open-webui)**, a framework for running LLM-based applications with tool integration.
+
+```
+Agents4Gov/
+├── tools/                 # Implemented tools for public services
+├── data/                  # Example or anonymized datasets
+├── docs/                  # Documentation and evaluation reports
+├── config/                # Model and system configuration files
+└── README.md              # Main project documentation
+```
+
+### Key Directories
+
+- **`tools/`** - Contains all tool implementations that can be imported into Open WebUI. Each tool is a Python class that provides specific functionality to agents.
+- **`data/`** - Stores datasets used for testing and evaluation, with privacy-preserving anonymization.
+- **`docs/`** - Documentation, tutorials, and research reports.
+- **`config/`** - Configuration files for models and system settings.
+
+## Available Documentation
+
+- **[How to Create a Tool](how_to_create_tool.md)** - A comprehensive step-by-step guide for creating custom tools that can be used by agents. Learn about tool structure, parameter validation, error handling, and best practices. Reference implementation: `tools/open_alex_doi.py`
+
+## External Resources
+
+### Open WebUI Documentation
+
+Agents4Gov tools are designed to run within Open WebUI. For understanding the underlying framework:
+
+- **[Open WebUI GitHub](https://github.com/open-webui/open-webui)** - Main repository and source code
+- **[Open WebUI Documentation](https://docs.openwebui.com/)** - Official documentation for installation, configuration, and usage
+- **[Open WebUI Tools Guide](https://docs.openwebui.com/features/plugin/tools)** - Specific documentation on how tools work within Open WebUI
+
+### Getting Started with Open WebUI
+
+1. Install Open WebUI: `pip install open-webui`
+2. Start the server: `open-webui serve`
+3. Access the interface at [http://localhost:8080](http://localhost:8080)
+4. Import Agents4Gov tools through the Tools module in the UI
+
+## Contributing
+
+When adding new documentation:
+1. Create your markdown file in this `docs/` directory
+2. Update this README.md with a link to your new document
+3. Use clear, descriptive titles and include practical examples
+4. Follow the structure and style of existing documentation