vectorgov-cli 0.1.0__tar.gz

vectorgov_cli-0.1.0/.gitignore

@@ -0,0 +1,111 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Project specific
+*.log
+*.tmp
+
+# Docker
+.docker/
+
+# Model files (large files)
+*.bin
+*.onnx
+*.pt
+*.pth
+*.safetensors
+
+# Data files that should not be committed
+# Uncomment if needed:
+# extracao/data/output/
+
+# Credentials and secrets (NEVER commit)
+docs/conexoes.md
+*.credentials
+*.secrets
+.env.local
+.env.production
+

vectorgov_cli-0.1.0/PKG-INFO

@@ -0,0 +1,273 @@
+Metadata-Version: 2.4
+Name: vectorgov-cli
+Version: 0.1.0
+Summary: CLI para a API VectorGov - Busca semântica em legislação brasileira
+Project-URL: Homepage, https://vectorgov.io
+Project-URL: Documentation, https://vectorgov.io/documentacao
+Project-URL: Repository, https://github.com/euteajudo/vectorgov-cli
+Project-URL: Issues, https://github.com/euteajudo/vectorgov-cli/issues
+Author-email: VectorGov <contato@vectorgov.io>
+License-Expression: MIT
+Keywords: brazil,cli,legal,legislation,licitacao,rag,semantic-search,vectorgov
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Linguistic
+Requires-Python: >=3.9
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.9.0
+Requires-Dist: vectorgov>=0.13.0
+Provides-Extra: all
+Requires-Dist: anthropic>=0.18.0; extra == 'all'
+Requires-Dist: google-generativeai>=0.3.0; extra == 'all'
+Requires-Dist: langchain-core>=0.1.0; extra == 'all'
+Requires-Dist: langchain>=0.1.0; extra == 'all'
+Requires-Dist: openai>=1.0.0; extra == 'all'
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.18.0; extra == 'anthropic'
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: isort>=5.12.0; extra == 'dev'
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Provides-Extra: google
+Requires-Dist: google-generativeai>=0.3.0; extra == 'google'
+Provides-Extra: langchain
+Requires-Dist: langchain-core>=0.1.0; extra == 'langchain'
+Requires-Dist: langchain>=0.1.0; extra == 'langchain'
+Provides-Extra: openai
+Requires-Dist: openai>=1.0.0; extra == 'openai'
+Description-Content-Type: text/markdown
+
+# VectorGov CLI
+
+Cliente de linha de comando para a API VectorGov - Busca semântica em legislação brasileira.
+
+[![PyPI version](https://badge.fury.io/py/vectorgov-cli.svg)](https://badge.fury.io/py/vectorgov-cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Instalação
+
+```bash
+pip install vectorgov-cli
+```
+
+## Configuração
+
+```bash
+# Configure sua API key
+vectorgov auth login
+
+# Ou via variável de ambiente
+export VECTORGOV_API_KEY="vg_sua_chave"
+```
+
+## Uso
+
+### Busca
+
+```bash
+# Busca simples
+vectorgov search "O que é ETP?"
+
+# Com opções
+vectorgov search "pesquisa de preços" --top-k 10 --mode precise
+
+# Saída em JSON
+vectorgov search "licitação" --output json
+
+# JSON bruto (para pipes)
+vectorgov search "licitação" --raw | jq '.hits[0].text'
+```
+
+### Perguntas (contexto para LLM)
+
+O comando `ask` busca contexto relevante para você usar com seu próprio LLM (OpenAI, Anthropic, Google, etc).
+
+```bash
+# Busca contexto para pergunta
+vectorgov ask "O que é ETP?"
+
+# Com mais contexto
+vectorgov ask "Quando o ETP pode ser dispensado?" --top-k 10 --mode precise
+
+# Saída em formato messages (pronto para LLM)
+vectorgov ask "critérios de julgamento" --output json
+
+# Mostrar código de exemplo para integração
+vectorgov ask "O que é ETP?" --code
+```
+
+**Exemplo de integração com OpenAI:**
+
+```python
+from vectorgov import VectorGov
+from openai import OpenAI
+
+vg = VectorGov(api_key="vg_xxx")
+openai = OpenAI()
+
+results = vg.search("O que é ETP?", top_k=5)
+
+response = openai.chat.completions.create(
+    model="gpt-4o",
+    messages=results.to_messages("O que é ETP?")
+)
+print(response.choices[0].message.content)
+```
+
+### Feedback
+
+```bash
+# Após uma busca, use o query_id para feedback
+vectorgov feedback abc123def456 --like
+vectorgov feedback abc123def456 --dislike
+```
+
+### Documentos
+
+```bash
+# Lista documentos disponíveis
+vectorgov docs list
+
+# Informações de um documento
+vectorgov docs info LEI-14133-2021
+```
+
+### Configuração
+
+```bash
+# Ver configuração atual
+vectorgov config list
+
+# Definir configuração
+vectorgov config set default_mode precise
+vectorgov config set default_top_k 10
+
+# Ver valor específico
+vectorgov config get api_key
+
+# Remover configuração
+vectorgov config delete default_mode
+```
+
+### Autenticação
+
+```bash
+# Login (salva API key)
+vectorgov auth login
+
+# Status da autenticação
+vectorgov auth status
+
+# Logout (remove API key)
+vectorgov auth logout
+```
+
+## Formatos de Saída
+
+### Tabela (padrão para search)
+
+```bash
+vectorgov search "O que é ETP?" --output table
+```
+
+```
+Resultados para: O que é ETP?
+Total: 5 | Latência: 1234ms | Cache: Não
+
+┏━━━┳━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━┓
+┃ # ┃ Artigo    ┃ Texto                                                          ┃ Score   ┃
+┡━━━╇━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━┩
+│ 1 │ Art. 3    │ ETP - Estudo Técnico Preliminar: documento constitutivo...     │ 0.892   │
+│ 2 │ Art. 1    │ Esta Instrução Normativa dispõe sobre a elaboração...          │ 0.856   │
+└───┴───────────┴────────────────────────────────────────────────────────────────┴─────────┘
+```
+
+### JSON
+
+```bash
+vectorgov search "O que é ETP?" --output json
+```
+
+```json
+{
+  "query": "O que é ETP?",
+  "total": 5,
+  "cached": false,
+  "latency_ms": 1234,
+  "hits": [
+    {
+      "text": "ETP - Estudo Técnico Preliminar...",
+      "article_number": "3",
+      "score": 0.892
+    }
+  ]
+}
+```
+
+## Integração com Outros Comandos
+
+```bash
+# Buscar e processar com jq
+vectorgov search "ETP" --raw | jq '.hits[0].text'
+
+# Buscar e salvar
+vectorgov search "licitação" --output json > resultados.json
+
+# Usar em scripts
+QUERY_ID=$(vectorgov search "ETP" --raw | jq -r '.query_id')
+vectorgov feedback $QUERY_ID --like
+
+# Obter contexto para LLM
+vectorgov ask "O que é ETP?" --raw | jq '.messages'
+```
+
+## Variáveis de Ambiente
+
+| Variável | Descrição |
+|----------|-----------|
+| `VECTORGOV_API_KEY` | API key para autenticação |
+| `VECTORGOV_DEFAULT_MODE` | Modo de busca padrão (fast, balanced, precise) |
+| `VECTORGOV_DEFAULT_TOP_K` | Número padrão de resultados |
+
+## Arquivo de Configuração
+
+Localização: `~/.vectorgov/config.yaml`
+
+```yaml
+api_key: vg_sua_chave
+default_mode: balanced
+default_top_k: 5
+output_format: table
+```
+
+## Ajuda
+
+```bash
+# Ajuda geral
+vectorgov --help
+
+# Ajuda de comando específico
+vectorgov search --help
+vectorgov ask --help
+```
+
+## Links
+
+- [Documentação](https://vectorgov.io/documentacao)
+- [Playground](https://vectorgov.io/playground)
+- [SDK Python](https://pypi.org/project/vectorgov/)
+- [SDK TypeScript](https://www.npmjs.com/package/vectorgov)

vectorgov_cli-0.1.0/README.md

@@ -0,0 +1,220 @@
+# VectorGov CLI
+
+Cliente de linha de comando para a API VectorGov - Busca semântica em legislação brasileira.
+
+[![PyPI version](https://badge.fury.io/py/vectorgov-cli.svg)](https://badge.fury.io/py/vectorgov-cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Instalação
+
+```bash
+pip install vectorgov-cli
+```
+
+## Configuração
+
+```bash
+# Configure sua API key
+vectorgov auth login
+
+# Ou via variável de ambiente
+export VECTORGOV_API_KEY="vg_sua_chave"
+```
+
+## Uso
+
+### Busca
+
+```bash
+# Busca simples
+vectorgov search "O que é ETP?"
+
+# Com opções
+vectorgov search "pesquisa de preços" --top-k 10 --mode precise
+
+# Saída em JSON
+vectorgov search "licitação" --output json
+
+# JSON bruto (para pipes)
+vectorgov search "licitação" --raw | jq '.hits[0].text'
+```
+
+### Perguntas (contexto para LLM)
+
+O comando `ask` busca contexto relevante para você usar com seu próprio LLM (OpenAI, Anthropic, Google, etc).
+
+```bash
+# Busca contexto para pergunta
+vectorgov ask "O que é ETP?"
+
+# Com mais contexto
+vectorgov ask "Quando o ETP pode ser dispensado?" --top-k 10 --mode precise
+
+# Saída em formato messages (pronto para LLM)
+vectorgov ask "critérios de julgamento" --output json
+
+# Mostrar código de exemplo para integração
+vectorgov ask "O que é ETP?" --code
+```
+
+**Exemplo de integração com OpenAI:**
+
+```python
+from vectorgov import VectorGov
+from openai import OpenAI
+
+vg = VectorGov(api_key="vg_xxx")
+openai = OpenAI()
+
+results = vg.search("O que é ETP?", top_k=5)
+
+response = openai.chat.completions.create(
+    model="gpt-4o",
+    messages=results.to_messages("O que é ETP?")
+)
+print(response.choices[0].message.content)
+```
+
+### Feedback
+
+```bash
+# Após uma busca, use o query_id para feedback
+vectorgov feedback abc123def456 --like
+vectorgov feedback abc123def456 --dislike
+```
+
+### Documentos
+
+```bash
+# Lista documentos disponíveis
+vectorgov docs list
+
+# Informações de um documento
+vectorgov docs info LEI-14133-2021
+```
+
+### Configuração
+
+```bash
+# Ver configuração atual
+vectorgov config list
+
+# Definir configuração
+vectorgov config set default_mode precise
+vectorgov config set default_top_k 10
+
+# Ver valor específico
+vectorgov config get api_key
+
+# Remover configuração
+vectorgov config delete default_mode
+```
+
+### Autenticação
+
+```bash
+# Login (salva API key)
+vectorgov auth login
+
+# Status da autenticação
+vectorgov auth status
+
+# Logout (remove API key)
+vectorgov auth logout
+```
+
+## Formatos de Saída
+
+### Tabela (padrão para search)
+
+```bash
+vectorgov search "O que é ETP?" --output table
+```
+
+```
+Resultados para: O que é ETP?
+Total: 5 | Latência: 1234ms | Cache: Não
+
+┏━━━┳━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━┓
+┃ # ┃ Artigo    ┃ Texto                                                          ┃ Score   ┃
+┡━━━╇━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━┩
+│ 1 │ Art. 3    │ ETP - Estudo Técnico Preliminar: documento constitutivo...     │ 0.892   │
+│ 2 │ Art. 1    │ Esta Instrução Normativa dispõe sobre a elaboração...          │ 0.856   │
+└───┴───────────┴────────────────────────────────────────────────────────────────┴─────────┘
+```
+
+### JSON
+
+```bash
+vectorgov search "O que é ETP?" --output json
+```
+
+```json
+{
+  "query": "O que é ETP?",
+  "total": 5,
+  "cached": false,
+  "latency_ms": 1234,
+  "hits": [
+    {
+      "text": "ETP - Estudo Técnico Preliminar...",
+      "article_number": "3",
+      "score": 0.892
+    }
+  ]
+}
+```
+
+## Integração com Outros Comandos
+
+```bash
+# Buscar e processar com jq
+vectorgov search "ETP" --raw | jq '.hits[0].text'
+
+# Buscar e salvar
+vectorgov search "licitação" --output json > resultados.json
+
+# Usar em scripts
+QUERY_ID=$(vectorgov search "ETP" --raw | jq -r '.query_id')
+vectorgov feedback $QUERY_ID --like
+
+# Obter contexto para LLM
+vectorgov ask "O que é ETP?" --raw | jq '.messages'
+```
+
+## Variáveis de Ambiente
+
+| Variável | Descrição |
+|----------|-----------|
+| `VECTORGOV_API_KEY` | API key para autenticação |
+| `VECTORGOV_DEFAULT_MODE` | Modo de busca padrão (fast, balanced, precise) |
+| `VECTORGOV_DEFAULT_TOP_K` | Número padrão de resultados |
+
+## Arquivo de Configuração
+
+Localização: `~/.vectorgov/config.yaml`
+
+```yaml
+api_key: vg_sua_chave
+default_mode: balanced
+default_top_k: 5
+output_format: table
+```
+
+## Ajuda
+
+```bash
+# Ajuda geral
+vectorgov --help
+
+# Ajuda de comando específico
+vectorgov search --help
+vectorgov ask --help
+```
+
+## Links
+
+- [Documentação](https://vectorgov.io/documentacao)
+- [Playground](https://vectorgov.io/playground)
+- [SDK Python](https://pypi.org/project/vectorgov/)
+- [SDK TypeScript](https://www.npmjs.com/package/vectorgov)

vectorgov_cli-0.1.0/pyproject.toml

@@ -0,0 +1,103 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "vectorgov-cli"
+version = "0.1.0"
+description = "CLI para a API VectorGov - Busca semântica em legislação brasileira"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [
+    { name = "VectorGov", email = "contato@vectorgov.io" }
+]
+keywords = [
+    "vectorgov",
+    "legal",
+    "legislation",
+    "semantic-search",
+    "rag",
+    "licitacao",
+    "brazil",
+    "cli"
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Text Processing :: Linguistic",
+]
+dependencies = [
+    "vectorgov>=0.13.0",
+    "typer>=0.9.0",
+    "rich>=13.0.0",
+    "pyyaml>=6.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-cov>=4.0.0",
+    "black>=23.0.0",
+    "isort>=5.12.0",
+    "mypy>=1.0.0",
+    "ruff>=0.1.0",
+]
+openai = ["openai>=1.0.0"]
+anthropic = ["anthropic>=0.18.0"]
+google = ["google-generativeai>=0.3.0"]
+langchain = ["langchain>=0.1.0", "langchain-core>=0.1.0"]
+all = [
+    "openai>=1.0.0",
+    "anthropic>=0.18.0",
+    "google-generativeai>=0.3.0",
+    "langchain>=0.1.0",
+    "langchain-core>=0.1.0",
+]
+
+[project.scripts]
+vectorgov = "vectorgov.cli.main:main"
+
+[project.urls]
+Homepage = "https://vectorgov.io"
+Documentation = "https://vectorgov.io/documentacao"
+Repository = "https://github.com/euteajudo/vectorgov-cli"
+Issues = "https://github.com/euteajudo/vectorgov-cli/issues"
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/README.md",
+    "/LICENSE",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/vectorgov"]
+
+[tool.black]
+line-length = 100
+target-version = ["py39", "py310", "py311", "py312"]
+
+[tool.isort]
+profile = "black"
+line_length = 100
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+
+[tool.mypy]
+python_version = "3.9"
+strict = true
+warn_return_any = true
+warn_unused_ignores = true

vectorgov_cli-0.1.0/src/vectorgov/cli/__init__.py

@@ -0,0 +1,12 @@
+"""
+VectorGov CLI - Cliente de linha de comando para a API VectorGov.
+
+Uso:
+    vectorgov search "O que é ETP?"
+    vectorgov ask "Quando o ETP pode ser dispensado?"
+    vectorgov auth login
+"""
+
+from .main import app
+
+__all__ = ["app"]