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.11

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.11
File	Size	Uploaded
atto_personal_agent-0.1.11.tar.gz	73.9 kB	Aug 13, 2026	Details

Built distribution (wheel)

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

Total release size: 179.8 kB

Release files / atto_personal_agent-0.1.11.tar.gz

Download URL	atto_personal_agent-0.1.11.tar.gz
Size	73.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`31f1b2b71adfdac6b0302b677c0af0e36debf81fd7e7937318314d20a133371f`
BLAKE2b-256 checksum How to use checksums	`698ddee0cdc7ccc841b39abf75c281a0f7f30742277c83b5c3f07291144806db`
Upload date	Aug 13, 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/872f1b0487e2ad88e7e41f1704242b96fa1d4e15

Workflow

Publishing configuration: github.com/Atto-Personal-Assistant/agent/blob/872f1b0487e2ad88e7e41f1704242b96fa1d4e15/.github/workflows/publish.yml
Publishing logs: github.com/Atto-Personal-Assistant/agent/actions/runs/31753484617/attempts/1

Artifact

Subject: atto_personal_agent-0.1.11.tar.gz
SHA-256 checksum: 31f1b2b71adfdac6b0302b677c0af0e36debf81fd7e7937318314d20a133371f Verifying attestations

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

Download URL	atto_personal_agent-0.1.11-py3-none-any.whl
Size	105.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`3a76922806ef11a6bcd257ce28f2612fc06b3581d50bc65a10bbe48a5d14476b`
BLAKE2b-256 checksum How to use checksums	`2cb8cccb157ba006293f2fb387708208ad121bba5e23fa216723f2934423eb53`
Upload date	Aug 13, 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/872f1b0487e2ad88e7e41f1704242b96fa1d4e15

Workflow

Publishing configuration: github.com/Atto-Personal-Assistant/agent/blob/872f1b0487e2ad88e7e41f1704242b96fa1d4e15/.github/workflows/publish.yml
Publishing logs: github.com/Atto-Personal-Assistant/agent/actions/runs/31753484617/attempts/1

Artifact

Subject: atto_personal_agent-0.1.11-py3-none-any.whl
SHA-256 checksum: 3a76922806ef11a6bcd257ce28f2612fc06b3581d50bc65a10bbe48a5d14476b Verifying attestations