pygent 0.1.0__tar.gz → 0.1.1__tar.gz

pygent-0.1.1/PKG-INFO

@@ -0,0 +1,18 @@
+Metadata-Version: 2.4
+Name: pygent
+Version: 0.1.1
+Summary: Pygent é um assistente de código minimalista que executa comandos em contêiner Docker quando disponível, com fallback para execução local. Veja https://marianochaves.github.io/pygent para a documentação e https://github.com/marianochaves/pygent para o código-fonte.
+Author-email: Mariano Chaves <mchaves.software@gmail.com>
+Project-URL: Documentation, https://marianochaves.github.io/pygent
+Project-URL: Repository, https://github.com/marianochaves/pygent
+Requires-Python: >=3.9
+License-File: LICENSE
+Requires-Dist: openai>=1.0.0
+Requires-Dist: rich>=13.7.0
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Provides-Extra: docs
+Requires-Dist: mkdocs; extra == "docs"
+Provides-Extra: docker
+Requires-Dist: docker>=7.0.0; extra == "docker"
+Dynamic: license-file

pygent-0.1.1/README.md

@@ -0,0 +1,79 @@
+# Pygent
+
+Pygent é um assistente de código que executa cada solicitação em um container Docker isolado sempre que possível. Caso Docker não esteja disponível (por exemplo em algumas instalações do Windows), o Pygent ainda funciona executando os comandos localmente.
+
+## Recursos
+
+* Execução de comandos em containers efêmeros (imagem padrão `python:3.12-slim`).
+* Integração com modelos da OpenAI para orquestração das etapas.
+* Histórico persistente das interações durante a sessão.
+* API Python simples para integração em outros projetos.
+
+## Instalação
+
+Recomenda-se instalar a partir do código fonte:
+
+```bash
+pip install -e .
+```
+
+É necessário possuir Python ≥ 3.9. As dependências de runtime são `openai` e `rich`. Para executar dentro de containers Docker instale também `pygent[docker]`.
+
+## Configuração
+
+O comportamento pode ser ajustado via variáveis de ambiente:
+
+* `OPENAI_API_KEY` – chave para acesso à API da OpenAI.
+* `PYGENT_MODEL` – modelo utilizado nas chamadas (padrão `gpt-4o-mini-preview`).
+* `PYGENT_IMAGE` – imagem Docker para criar o container (padrão `python:3.12-slim`).
+* `PYGENT_USE_DOCKER` – defina `0` para desabilitar Docker e executar localmente.
+
+## Uso via CLI
+
+Após instalar, execute:
+
+```bash
+pygent
+```
+
+Use `--docker` para executar os comandos dentro de um container (requere
+`pygent[docker]`). Utilize `--no-docker` ou defina `PYGENT_USE_DOCKER=0`
+para forçar a execução local.
+
+Digite mensagens normalmente; utilize `/exit` para encerrar a sessão. Todo comando é executado dentro do container e o resultado é exibido no terminal.
+
+## Uso via API
+
+Também é possível interagir diretamente com o código Python:
+
+```python
+from pygent import Agent
+
+ag = Agent()
+ag.step("echo 'Ola Mundo'")
+# ... demias passos
+ag.runtime.cleanup()
+```
+
+Confira a pasta `examples/` para scripts mais completos.
+
+## Desenvolvimento
+
+1. Instale as dependências de teste:
+
+```bash
+pip install -e .[test]
+```
+
+2. Rode o conjunto de testes:
+
+```bash
+pytest
+```
+
+Para gerar a documentação localmente utilize `mkdocs serve`.
+
+## Licença
+
+Este projeto é distribuído sob a licença MIT. Consulte o arquivo `LICENSE` para mais detalhes.
+

{pygent-0.1.0 → pygent-0.1.1}/pygent/agent.py

@@ -55,8 +55,8 @@ class Agent:
             console.print(assistant_msg.content)
 
 
-def run_interactive() -> None:  # pragma: no cover
-    agent = Agent()
+def run_interactive(use_docker: bool | None = None) -> None:  # pragma: no cover
+    agent = Agent(runtime=Runtime(use_docker=use_docker))
     console.print("[bold green]Pygent[/] iniciado. (digite /exit para sair)")
     try:
         while True:

pygent-0.1.1/pygent/cli.py

@@ -0,0 +1,12 @@
+"""Ponto de entrada da CLI do Pygent."""
+import argparse
+
+from .agent import run_interactive
+
+def main() -> None:  # pragma: no cover
+    parser = argparse.ArgumentParser(prog="pygent")
+    parser.add_argument("--docker", dest="use_docker", action="store_true", help="executar em container Docker")
+    parser.add_argument("--no-docker", dest="use_docker", action="store_false", help="executar localmente")
+    parser.set_defaults(use_docker=None)
+    args = parser.parse_args()
+    run_interactive(use_docker=args.use_docker)

pygent-0.1.1/pygent/runtime.py

@@ -0,0 +1,86 @@
+"""Executa comandos em um container Docker, caindo para execução local se necessário."""
+from __future__ import annotations
+
+import os
+import shutil
+import subprocess
+import tempfile
+import uuid
+from pathlib import Path
+from typing import Union
+
+try:  # Docker may not be available (e.g. Windows without Docker)
+    import docker  # type: ignore
+except Exception:  # pragma: no cover - optional dependency
+    docker = None
+
+
+class Runtime:
+    """Executa comandos em um container Docker ou localmente se Docker faltar."""
+
+    def __init__(self, image: str | None = None, use_docker: bool | None = None) -> None:
+        self.base_dir = Path(tempfile.mkdtemp(prefix="pygent_"))
+        self.image = image or os.getenv("PYGENT_IMAGE", "python:3.12-slim")
+        env_opt = os.getenv("PYGENT_USE_DOCKER")
+        if use_docker is None:
+            use_docker = (env_opt != "0") if env_opt is not None else True
+        self._use_docker = bool(docker) and use_docker
+        if self._use_docker:
+            try:
+                self.client = docker.from_env()
+                self.container = self.client.containers.run(
+                    self.image,
+                    name=f"pygent-{uuid.uuid4().hex[:8]}",
+                    command="sleep infinity",
+                    volumes={str(self.base_dir): {"bind": "/workspace", "mode": "rw"}},
+                    working_dir="/workspace",
+                    detach=True,
+                    tty=True,
+                    network_disabled=True,
+                    mem_limit="512m",
+                    pids_limit=256,
+                )
+            except Exception:
+                self._use_docker = False
+        if not self._use_docker:
+            self.client = None
+            self.container = None
+
+    # ---------------- public API ----------------
+    def bash(self, cmd: str, timeout: int = 30) -> str:
+        """Roda comando no container ou localmente e devolve a saída."""
+        if self._use_docker and self.container is not None:
+            res = self.container.exec_run(
+                cmd,
+                workdir="/workspace",
+                demux=True,
+                tty=False,
+                timeout=timeout,
+            )
+            stdout, stderr = (
+                res.output if isinstance(res.output, tuple) else (res.output, b"")
+            )
+            return (stdout or b"").decode() + (stderr or b"").decode()
+        proc = subprocess.run(
+            cmd,
+            shell=True,
+            cwd=self.base_dir,
+            capture_output=True,
+            text=True,
+            timeout=timeout,
+        )
+        return proc.stdout + proc.stderr
+
+    def write_file(self, rel_path: Union[str, Path], content: str) -> str:
+        p = self.base_dir / rel_path
+        p.parent.mkdir(parents=True, exist_ok=True)
+        p.write_text(content)
+        return f"Wrote {p.relative_to(self.base_dir)}"
+
+    def cleanup(self) -> None:
+        if self._use_docker and self.container is not None:
+            try:
+                self.container.kill()
+            finally:
+                self.container.remove(force=True)
+        shutil.rmtree(self.base_dir, ignore_errors=True)

pygent-0.1.1/pygent.egg-info/PKG-INFO

@@ -0,0 +1,18 @@
+Metadata-Version: 2.4
+Name: pygent
+Version: 0.1.1
+Summary: Pygent é um assistente de código minimalista que executa comandos em contêiner Docker quando disponível, com fallback para execução local. Veja https://marianochaves.github.io/pygent para a documentação e https://github.com/marianochaves/pygent para o código-fonte.
+Author-email: Mariano Chaves <mchaves.software@gmail.com>
+Project-URL: Documentation, https://marianochaves.github.io/pygent
+Project-URL: Repository, https://github.com/marianochaves/pygent
+Requires-Python: >=3.9
+License-File: LICENSE
+Requires-Dist: openai>=1.0.0
+Requires-Dist: rich>=13.7.0
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Provides-Extra: docs
+Requires-Dist: mkdocs; extra == "docs"
+Provides-Extra: docker
+Requires-Dist: docker>=7.0.0; extra == "docker"
+Dynamic: license-file

{pygent-0.1.0 → pygent-0.1.1}/pygent.egg-info/requires.txt

@@ -1,7 +1,9 @@
 openai>=1.0.0
-docker>=7.0.0
 rich>=13.7.0
 
+[docker]
+docker>=7.0.0
+
 [docs]
 mkdocs
 

{pygent-0.1.0 → pygent-0.1.1}/pyproject.toml

@@ -1,21 +1,25 @@
 [project]
 name = "pygent"
-version = "0.1.0"
-description = "A minimal agentic coding assistant that runs each task in a secure container."
+version = "0.1.1"
+description = "Pygent é um assistente de código minimalista que executa comandos em contêiner Docker quando disponível, com fallback para execução local. Veja https://marianochaves.github.io/pygent para a documentação e https://github.com/marianochaves/pygent para o código-fonte."
 authors = [ { name = "Mariano Chaves", email = "mchaves.software@gmail.com" } ]
 requires-python = ">=3.9"
 dependencies = [
     "openai>=1.0.0",   # interface com modelos da OpenAI
-    "docker>=7.0.0",    # manipular containers
     "rich>=13.7.0"      # saídas coloridas (opcional)
 ]
 
+[project.urls]
+Documentation = "https://marianochaves.github.io/pygent"
+Repository = "https://github.com/marianochaves/pygent"
+
 [project.scripts]
 pygent = "pygent.cli:main"
 
 [project.optional-dependencies]
 test = ["pytest"]
 docs = ["mkdocs"]
+docker = ["docker>=7.0.0"]
 
 [tool.setuptools.package-data]
 "pygent" = ["py.typed"]

pygent-0.1.0/PKG-INFO

@@ -1,15 +0,0 @@
-Metadata-Version: 2.4
-Name: pygent
-Version: 0.1.0
-Summary: A minimal agentic coding assistant that runs each task in a secure container.
-Author-email: Mariano Chaves <mchaves.software@gmail.com>
-Requires-Python: >=3.9
-License-File: LICENSE
-Requires-Dist: openai>=1.0.0
-Requires-Dist: docker>=7.0.0
-Requires-Dist: rich>=13.7.0
-Provides-Extra: test
-Requires-Dist: pytest; extra == "test"
-Provides-Extra: docs
-Requires-Dist: mkdocs; extra == "docs"
-Dynamic: license-file

pygent-0.1.0/README.md

@@ -1,40 +0,0 @@
-# Pygent
-
-Pygent é um assistente de código minimalista que executa cada tarefa em um
-container Docker isolado. O objetivo é facilitar execução de comandos de forma
-segura e reprodutível, mantendo o histórico de mensagens da conversa.
-
-## Instalação
-
-Recomendação mais simples é usar `pip`:
-
-```bash
-pip install -e .
-```
-
-O projeto requer Python ≥ 3.9 e depende de `docker`, `openai` e `rich`.
-
-## Uso via CLI
-
-Após instalado, inicie a interface interativa com:
-
-```bash
-pygent
-```
-
-Digita mensagens normalmente e utilize `/exit` para sair.
-
-## Uso via API
-
-Também é possível integrar diretamente com o código Python:
-
-```python
-from pygent import Agent
-
-ag = Agent()
-ag.step("echo hello")  # roda dentro do container
-ag.runtime.cleanup()
-```
-
-Veja a pasta `examples/` para scripts mais completos.
-

pygent-0.1.0/pygent/cli.py

@@ -1,5 +0,0 @@
-"""Ponto de entrada da CLI do Pygent."""
-from .agent import run_interactive
-
-def main() -> None:  # pragma: no cover
-    run_interactive()

pygent-0.1.0/pygent/runtime.py

@@ -1,53 +0,0 @@
-"""Isola as execuções num container Docker efêmero."""
-from __future__ import annotations
-
-import os
-import shutil
-import tempfile
-import subprocess
-import uuid
-from pathlib import Path
-from typing import Union
-
-import docker
-
-
-class Runtime:
-    """Cada instância corresponde a um diretório + container dedicados."""
-
-    def __init__(self, image: str | None = None) -> None:
-        self.base_dir = Path(tempfile.mkdtemp(prefix="pygent_"))
-        self.image = image or os.getenv("PYGENT_IMAGE", "python:3.12-slim")
-        self.client = docker.from_env()
-        self.container = self.client.containers.run(
-            self.image,
-            name=f"pygent-{uuid.uuid4().hex[:8]}",
-            command="sleep infinity",
-            volumes={str(self.base_dir): {"bind": "/workspace", "mode": "rw"}},
-            working_dir="/workspace",
-            detach=True,
-            tty=True,
-            network_disabled=True,
-            mem_limit="512m",
-            pids_limit=256,
-        )
-
-    # ---------------- public API ----------------
-    def bash(self, cmd: str, timeout: int = 30) -> str:
-        """Roda comando dentro do container e devolve saída combinada."""
-        res = self.container.exec_run(cmd, workdir="/workspace", demux=True, tty=False, timeout=timeout)
-        stdout, stderr = res.output if isinstance(res.output, tuple) else (res.output, b"")
-        return (stdout or b"").decode() + (stderr or b"").decode()
-
-    def write_file(self, rel_path: Union[str, Path], content: str) -> str:
-        p = self.base_dir / rel_path
-        p.parent.mkdir(parents=True, exist_ok=True)
-        p.write_text(content)
-        return f"Wrote {p.relative_to(self.base_dir)}"
-
-    def cleanup(self) -> None:
-        try:
-            self.container.kill()
-        finally:
-            self.container.remove(force=True)
-            shutil.rmtree(self.base_dir, ignore_errors=True)

pygent-0.1.0/pygent.egg-info/PKG-INFO

@@ -1,15 +0,0 @@
-Metadata-Version: 2.4
-Name: pygent
-Version: 0.1.0
-Summary: A minimal agentic coding assistant that runs each task in a secure container.
-Author-email: Mariano Chaves <mchaves.software@gmail.com>
-Requires-Python: >=3.9
-License-File: LICENSE
-Requires-Dist: openai>=1.0.0
-Requires-Dist: docker>=7.0.0
-Requires-Dist: rich>=13.7.0
-Provides-Extra: test
-Requires-Dist: pytest; extra == "test"
-Provides-Extra: docs
-Requires-Dist: mkdocs; extra == "docs"
-Dynamic: license-file