Metadata-Version: 2.4
Name: agents4gov-apps
Version: 0.1.0
Summary: Modular Python tool library for AI agents in Brazilian government applications
Project-URL: Homepage, https://github.com/Labic-ICMC-USP/Agents4GovApps
Project-URL: Repository, https://github.com/Labic-ICMC-USP/Agents4GovApps
Project-URL: Issues, https://github.com/Labic-ICMC-USP/Agents4GovApps/issues
Author: LABIC - ICMC/USP
License: GPL-3.0-or-later
License-File: LICENSE
Keywords: agents,brazil,cnpq,government,langchain,lattes,llm,open-webui,openalex,openml,tools
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: pydantic>=2.0
Requires-Dist: requests>=2.31
Provides-Extra: browser
Requires-Dist: browser-use; extra == 'browser'
Requires-Dist: langchain-openai; extra == 'browser'
Requires-Dist: playwright; extra == 'browser'
Provides-Extra: dev
Requires-Dist: build; extra == 'dev'
Requires-Dist: hatchling; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Provides-Extra: gnews
Requires-Dist: gnews; extra == 'gnews'
Requires-Dist: openpyxl; extra == 'gnews'
Requires-Dist: pandas; extra == 'gnews'
Requires-Dist: pyarrow; extra == 'gnews'
Requires-Dist: python-dateutil; extra == 'gnews'
Requires-Dist: python-dotenv; extra == 'gnews'
Provides-Extra: openml
Requires-Dist: joblib; extra == 'openml'
Requires-Dist: numpy; extra == 'openml'
Requires-Dist: openml; extra == 'openml'
Requires-Dist: pandas; extra == 'openml'
Requires-Dist: scikit-learn; extra == 'openml'
Requires-Dist: sentence-transformers; extra == 'openml'
Description-Content-Type: text/markdown

# Agents4GovApps

**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

```bash
# Base package
pip install agents4gov-apps

# With OpenML tools
pip install agents4gov-apps[openml]

# With browser-based tools (Lattes)
pip install agents4gov-apps[browser]

# With GNews collector
pip install agents4gov-apps[gnews]
```

## Quick start

```python
from agents4gov_apps import load_tool_instance
import json

# OpenAlex
tool = load_tool_instance("openalex_doi")
result = json.loads(tool.get_openalex_metadata_by_doi(doi="10.1038/s41586-021-03819-2"))

# GNews (async)
import asyncio
tool = load_tool_instance("gnews_collector")
result = asyncio.run(tool.collect_general_news(
    query='"ICMC USP"',
    start_year_month="2023-01",
    end_year_month="2024-12",
))
```

## Documentation

- **[Developer Guide](docs/developer_guide.md)** — architecture, standard interface, how to create and use tools across Open WebUI, LangChain, OpenAI, and other frameworks
- **[Tool Protocol](docs/tool_protocol.md)** — quick-reference packaging contract
- **[Available Tools](TOOLS.md)** — full list of tools with source links
