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) -> strviaAgentRuntime(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 + AZURE_REVIEWER_ID |
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
pytestpara garantir que tudo funciona - Abra um pull request
📄 Licença
MIT © Atto
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file atto_personal_agent-0.1.9.tar.gz.
File metadata
- Download URL: atto_personal_agent-0.1.9.tar.gz
- Upload date:
- Size: 59.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
64ebf2d9c58e65029621bab0020548a2dd91708ed538943d448f23240218817f
|
|
| MD5 |
801b9c38a3ac3e36611c0aff68265862
|
|
| BLAKE2b-256 |
0f9718a8f3682b32ab90ea979adad67e5c86be0197f465b6eaf95a6538e98b95
|
Provenance
The following attestation bundles were made for atto_personal_agent-0.1.9.tar.gz:
Publisher:
publish.yml on Atto-Personal-Assistant/agent
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
atto_personal_agent-0.1.9.tar.gz -
Subject digest:
64ebf2d9c58e65029621bab0020548a2dd91708ed538943d448f23240218817f - Sigstore transparency entry: 2427835206
- Sigstore integration time:
-
Permalink:
Atto-Personal-Assistant/agent@8f6a8c6efdb7f7df4268e0c9f73211ebf4637593 -
Branch / Tag:
refs/tags/v0.1.9 - Owner: https://github.com/Atto-Personal-Assistant
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@8f6a8c6efdb7f7df4268e0c9f73211ebf4637593 -
Trigger Event:
push
-
Statement type:
File details
Details for the file atto_personal_agent-0.1.9-py3-none-any.whl.
File metadata
- Download URL: atto_personal_agent-0.1.9-py3-none-any.whl
- Upload date:
- Size: 87.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ce0b3a06bd10a496d67d817976d8647e8e463d6f7704e45ebf883645b96f9b70
|
|
| MD5 |
4b7396cddfde8fe3cdeb3346017c90a1
|
|
| BLAKE2b-256 |
e3bde236bc50e2fb57c4bc7f18eec624106e12648a0cabb8158c007748605082
|
Provenance
The following attestation bundles were made for atto_personal_agent-0.1.9-py3-none-any.whl:
Publisher:
publish.yml on Atto-Personal-Assistant/agent
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
atto_personal_agent-0.1.9-py3-none-any.whl -
Subject digest:
ce0b3a06bd10a496d67d817976d8647e8e463d6f7704e45ebf883645b96f9b70 - Sigstore transparency entry: 2427835278
- Sigstore integration time:
-
Permalink:
Atto-Personal-Assistant/agent@8f6a8c6efdb7f7df4268e0c9f73211ebf4637593 -
Branch / Tag:
refs/tags/v0.1.9 - Owner: https://github.com/Atto-Personal-Assistant
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@8f6a8c6efdb7f7df4268e0c9f73211ebf4637593 -
Trigger Event:
push
-
Statement type:
