OpenAgentOS

English · Italiano

Italiano

Un runtime locale per agenti AI definiti in YAML. Ogni agente ha istruzioni, skill, provider e strumenti propri. Le chiamate ai tool passano per una policy esplicita; sessioni e audit restano in SQLite locale.

La demo animata dura cinque secondi e mostra il percorso realmente disponibile nell'MVP. L'agente demo restituisce una risposta deterministica per provare installazione e API senza scaricare modelli. project-manager usa Ollama per risposte AI reali.

Avvio rapido

Con Docker Compose:

docker compose up --build

Apri http://localhost:8765. Il servizio è esposto solo sull'interfaccia locale. Per provare senza Docker, con Python 3.11 o successivo:

python -m pip install -e .
python -m openagentos agents
python -m openagentos run demo "Ciao"
python -m openagentos serve

Per Ollama, installa un modello compatibile con tool calling e modifica model in agents/examples/project-manager.yaml se necessario. L'endpoint predefinito locale è http://127.0.0.1:11434/v1; in Compose è http://host.docker.internal:11434/v1. Per API OpenAI-compatible imposta OPENAI_COMPATIBLE_BASE_URL e OPENAI_COMPATIBLE_API_KEY, poi seleziona un manifest con provider.kind: openai-compatible.

I tool sono negati per default. Per abilitare time_now e history_search, imposta OPENAGENTOS_ALLOWED_TOOLS=time_now,history_search; l'agente deve anche elencarli nel proprio YAML. history_search vede solo la sessione corrente.

Cosa include l'MVP

• Manifest YAML versionati, validati e caricati da agents/ e agents/examples/.
• Skill Markdown locali in plugins/skills/.
• Provider Ollama e Chat Completions OpenAI-compatible, più un provider demo offline.
• Loop di tool calling con permessi dell'host e dell'agente, limite di iterazioni e log audit.
• Sessioni SQLite ispezionabili e cancellabili; API REST, CLI e UI web bilingue.
• Compose con bind a 127.0.0.1 e volume dati persistente.

L'MVP è a utente singolo, locale. Non include ancora installazione da registry remoto, sandbox di plugin eseguibili, cron o connettori GitHub/n8n. Vedi Roadmap.

Contribuire e sostenere

Il core Python è volutamente sotto 1.500 righe. Una nuova skill testuale richiede un file Markdown e un riferimento nel manifest: guida ai contributi. Il link per sostenere il progetto appare solo al termine dell'output CLI interattivo; --quiet/--no-sponsor, OPENAGENTOS_NO_SPONSOR=1 e CI lo disattivano. Puoi sostenere il progetto tramite Buy Me a Coffee, PayPal o Ko-fi. Il profilo GitHub Sponsors è in attesa di attivazione.

Codice sotto AGPLv3. La licenza consente uso commerciale e vendita, imponendo condizioni di condivisione del codice nei casi previsti; vedi licenza e contributi, asset, avvisi sulle dipendenze, supporto, codice di condotta e piano di sviluppo. Le release includono un identificatore di provenienza; non è una protezione tecnica contro la copia. Il nome e gli eventuali marchi non sono concessi dalla licenza del codice.

English

A local runtime for YAML-defined AI agents. Each agent has its own instructions, skills, provider, and tools. Tool calls pass through an explicit policy; sessions and audit events stay in local SQLite.

The five-second animation shows an actual MVP flow. The demo agent returns a deterministic response so you can test installation and API access without downloading a model. project-manager uses Ollama for real AI responses.

Quick start

With Docker Compose:

docker compose up --build

Open http://localhost:8765. The service binds to the local interface only. Without Docker, use Python 3.11 or newer:

python -m pip install -e .
python -m openagentos agents
python -m openagentos run demo "Hello"
python -m openagentos serve

For Ollama, install a model that supports tool calling and change model in agents/examples/project-manager.yaml if needed. The default local endpoint is http://127.0.0.1:11434/v1; Compose uses http://host.docker.internal:11434/v1. For an OpenAI-compatible API, set OPENAI_COMPATIBLE_BASE_URL and OPENAI_COMPATIBLE_API_KEY, then select a manifest with provider.kind: openai-compatible.

Tools are denied by default. To allow time_now and history_search, set OPENAGENTOS_ALLOWED_TOOLS=time_now,history_search; the agent must also declare each tool in YAML. history_search sees only the current session.

MVP scope

• Validated, versioned YAML manifests loaded from agents/ and agents/examples/.
• Local Markdown skills in plugins/skills/.
• Ollama and OpenAI-compatible Chat Completions providers, plus an offline demo provider.
• Tool calling with host and agent permissions, iteration limits, and audit events.
• Inspectable and deletable SQLite sessions; REST API, CLI, and bilingual web UI.
• Compose with a 127.0.0.1 bind and persistent data volume.

This is a local, single-user MVP. Remote registry installation, executable plugin sandboxing, cron, and GitHub/n8n connectors are future work. See the roadmap.

Contribute and support

The Python core is deliberately below 1,500 lines. A new text skill needs one Markdown file and one manifest reference: contribution guide. The support link appears only after interactive CLI output; --quiet/--no-sponsor, OPENAGENTOS_NO_SPONSOR=1, and CI disable it. Support the project through Buy Me a Coffee, PayPal, or Ko-fi. The GitHub Sponsors profile is pending activation.

Code is licensed under AGPLv3. It permits commercial use and sales while requiring source sharing in specified circumstances; see licensing and contributions, assets, third-party notices, support, code of conduct, and the development plan. Releases carry a provenance identifier, which is not a technical copy protection mechanism. The code license does not grant rights to the name or any trademarks.