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

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.12
File	Size	Uploaded
atto_personal_agent-0.1.12.tar.gz	76.3 kB	Aug 13, 2026	Details

Built distribution (wheel)

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

Total release size: 184.9 kB

Release files / atto_personal_agent-0.1.12.tar.gz

Download URL	atto_personal_agent-0.1.12.tar.gz
Size	76.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`f8e7f6d8b0ed7507b4876976abdd7f1a3285383615effa24e6b4c88e0505a022`
BLAKE2b-256 checksum How to use checksums	`d7c59811ab71e4429d7fb8f8f306b308783ad866ed5cc583d10e204be409a816`
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/e7e5c9cff5d05ab291ee11a8374d9424770cda23

Workflow

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

Artifact

Subject: atto_personal_agent-0.1.12.tar.gz
SHA-256 checksum: f8e7f6d8b0ed7507b4876976abdd7f1a3285383615effa24e6b4c88e0505a022 Verifying attestations

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

Download URL	atto_personal_agent-0.1.12-py3-none-any.whl
Size	108.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`296a5569f848405498b91e0e24101698ff498ee5f6687d3ef19d49af0a858c8f`
BLAKE2b-256 checksum How to use checksums	`223c0f3a18fdebadf711de4b9a1b40d3adfd2ee6cc17ac2054a1cfb91718d137`
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/e7e5c9cff5d05ab291ee11a8374d9424770cda23

Workflow

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

Artifact

Subject: atto_personal_agent-0.1.12-py3-none-any.whl
SHA-256 checksum: 296a5569f848405498b91e0e24101698ff498ee5f6687d3ef19d49af0a858c8f Verifying attestations