Atto Agent

Biblioteca Python do agente do Atto Personal Assistant.

📦 Instalação

pip install atto-personal-agent

🚀 Uso rápido

from atto_agent import AgentRuntime

runtime = AgentRuntime(
    ollama_url="https://seu-servidor-ollama.example.com",
    ollama_model="qwen2.5-coder:3b",
)
# Planeja uma ação
decision = runtime.plan("Explique este projeto")
# Executa a ação
result = runtime.run(decision, "Explique este projeto")
print(result)

Dica: Se sua aplicação já possui um LLM, basta injetar um objeto que implemente generate(prompt: str) -> str via AgentRuntime(llm=...).

☁️ Integração com Ollama Cloud

Configure as variáveis de ambiente:

export OLLAMA_URL=https://ollama.com
export OLLAMA_API_KEY=seu_api_key
export OLLAMA_MODEL=nome_do_modelo

🛠️ Desenvolvimento autônomo

O agente possui a capability software_engineer que permite:

criar branches atto/*
editar arquivos
executar testes
criar commits, push e abrir pull requests

Para habilitar, configure:

export ATTO_WORKSPACE=/caminho/para/repo
export ATTO_INTERNAL_TOKEN=seu_token_secreto

Credenciais de CI/CD

Plataforma	Token de PR	Token de aprovação	Observação
GitHub	`GITHUB_TOKEN`	`GITHUB_APPROVAL_TOKEN`	Identidade separada
Azure DevOps	`AZURE_TOKEN`	`AZURE_APPROVAL_TOKEN`	Identidade separada

Uma revisão remota do Azure precisa apenas de AZURE_TOKEN e da URL completa do PR. ATTO_WORKSPACE não é necessário nesse cenário.

Comando de testes

Defina ATTO_TEST_COMMAND se o projeto usar um comando customizado. Caso contrário, o runtime detecta automaticamente python -m unittest ou npm test.

🤝 Contribuindo

Fork o repositório
Crie uma branch atto/feature-nome
Faça suas alterações
Execute pytest para garantir que tudo funciona
Abra um pull request

📄 Licença

MIT © Atto

Metadata

Release files for atto-personal-agent 0.1.13

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for atto-personal-agent 0.1.13
File	Size	Uploaded
atto_personal_agent-0.1.13.tar.gz	76.3 kB	Aug 14, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for atto-personal-agent 0.1.13
File	Interpreter	ABI	Platform	Reset
atto_personal_agent-0.1.13-py3-none-any.whl 108.7 kB Aug 14, 2026	Python 3	none	any	Details

Total release size: 184.9 kB

Release files / atto_personal_agent-0.1.13.tar.gz

Download URL	atto_personal_agent-0.1.13.tar.gz
Size	76.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`1655fe0b863fef126f546a17564d3d6309054fce1232848f0e7780fe485599f5`
BLAKE2b-256 checksum How to use checksums	`9c3b687eacb986fcca1f25c8ca6fdaabe6c9c6bc49cf46781453d7f094adff46`
Upload date	Aug 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Atto-Personal-Assistant/agent
Publishing commit: github.com/Atto-Personal-Assistant/agent/tree/4e5e0e0bea9c65045a9c19c5e16fed96f37f2782

Workflow

Publishing configuration: github.com/Atto-Personal-Assistant/agent/blob/4e5e0e0bea9c65045a9c19c5e16fed96f37f2782/.github/workflows/publish.yml
Publishing logs: github.com/Atto-Personal-Assistant/agent/actions/runs/31756045277/attempts/1

Artifact

Subject: atto_personal_agent-0.1.13.tar.gz
SHA-256 checksum: 1655fe0b863fef126f546a17564d3d6309054fce1232848f0e7780fe485599f5 Verifying attestations

Release files / atto_personal_agent-0.1.13-py3-none-any.whl

Download URL	atto_personal_agent-0.1.13-py3-none-any.whl
Size	108.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`5bf032f73ad0b0474b1d4978f08a1064c3a1c4fe4fdd9789890a55aaabe2f916`
BLAKE2b-256 checksum How to use checksums	`ae789f3e0f1bac5ec06edc31de059ab201ef28cc8e61d79c94b7ebe316c9560f`
Upload date	Aug 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Atto-Personal-Assistant/agent
Publishing commit: github.com/Atto-Personal-Assistant/agent/tree/4e5e0e0bea9c65045a9c19c5e16fed96f37f2782

Workflow

Publishing configuration: github.com/Atto-Personal-Assistant/agent/blob/4e5e0e0bea9c65045a9c19c5e16fed96f37f2782/.github/workflows/publish.yml
Publishing logs: github.com/Atto-Personal-Assistant/agent/actions/runs/31756045277/attempts/1

Artifact

Subject: atto_personal_agent-0.1.13-py3-none-any.whl
SHA-256 checksum: 5bf032f73ad0b0474b1d4978f08a1064c3a1c4fe4fdd9789890a55aaabe2f916 Verifying attestations