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

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.14
File	Size	Uploaded
atto_personal_agent-0.1.14.tar.gz	76.4 kB	Aug 14, 2026	Details

Built distribution (wheel)

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

Total release size: 185.0 kB

Release files / atto_personal_agent-0.1.14.tar.gz

Download URL	atto_personal_agent-0.1.14.tar.gz
Size	76.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`9e6a72c2409ff21840fb0bd5ee92b2b13383256ad554ff85cb438abb4e9550fd`
BLAKE2b-256 checksum How to use checksums	`978ca363b7f7416a917b4fab31155c5e9e3512eb04ff7832df488d1d778ce20c`
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/bfcc525aca6a0a429638ca2baf5e528b6df39bb9

Workflow

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

Artifact

Subject: atto_personal_agent-0.1.14.tar.gz
SHA-256 checksum: 9e6a72c2409ff21840fb0bd5ee92b2b13383256ad554ff85cb438abb4e9550fd Verifying attestations

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

Download URL	atto_personal_agent-0.1.14-py3-none-any.whl
Size	108.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b939c5d35e1e26b31100d7e65ac7f50f84ad02050044857c984d978de25dadaf`
BLAKE2b-256 checksum How to use checksums	`f219570519f636381a6874f74026bb7dfd2f8dcb3e4777ed5d2e5e9edb12a80c`
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/bfcc525aca6a0a429638ca2baf5e528b6df39bb9

Workflow

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

Artifact

Subject: atto_personal_agent-0.1.14-py3-none-any.whl
SHA-256 checksum: b939c5d35e1e26b31100d7e65ac7f50f84ad02050044857c984d978de25dadaf Verifying attestations