https://github.com/awaku7/agentcli
LLM agent running on your local PC, Compatible with various LLM models. Can do anything.
https://github.com/awaku7/agentcli
a2a a2a-client a2a-server agentic-ai azure chatcompletion-api claude gemini gemini-api mcp-client nvidia openai openrouter python responses-api xai
Last synced: about 1 month ago
JSON representation
LLM agent running on your local PC, Compatible with various LLM models. Can do anything.
- Host: GitHub
- URL: https://github.com/awaku7/agentcli
- Owner: awaku7
- License: apache-2.0
- Created: 2026-02-11T04:21:24.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-04-14T12:18:18.000Z (about 2 months ago)
- Last Synced: 2026-04-14T14:27:52.169Z (about 2 months ago)
- Topics: a2a, a2a-client, a2a-server, agentic-ai, azure, chatcompletion-api, claude, gemini, gemini-api, mcp-client, nvidia, openai, openrouter, python, responses-api, xai
- Language: Python
- Homepage:
- Size: 4.47 MB
- Stars: 4
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.de.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
```
██╗ ██╗ █████╗ ██████╗ ███████╗███╗ ██╗████████╗ ██████╗██╗ ██╗
██║ ██║██╔══██╗██╔════╝ ██╔════╝████╗ ██║╚══██╔══╝██╔════╝██║ ██║
██║ ██║███████║██║ ███╗█████╗ ██╔██╗ ██║ ██║ ██║ ██║ ██║
██║ ██║██╔══██║██║ ██║██╔══╝ ██║╚██╗██║ ██║ ██║ ██║ ██║
╚██████╔╝██║ ██║╚██████╔╝███████╗██║ ╚████║ ██║ ╚██████╗███████╗██║
╚═════╝ ╚═╝ ╚═╝ ╚═════╝ ╚══════╝╚═╝ ╚═══╝ ╚═╝ ╚═════╝╚══════╝╚═╝
```
# uag (Lokaler KI-Agent)
uag ist ein interaktiver Agent, der **Befehle** ausführt, **Dateien** manipuliert und **verschiedene Datenformate** (PDF/PPTX/Excel usw.) auf Ihrem lokalen PC liest. Er bietet drei Schnittstellen: CLI, GUI und Web.
## Installation
Sie können `uag` über pip installieren:
```bash
pip install uag
```
Nach der Installation wird beim ersten Start von `uag` automatisch ein **interaktiver Einrichtungsassistent** gestartet, um Ihre Umgebungsvariablen zu konfigurieren. Ausführliche Informationen zur Konfiguration und Verschlüsselung finden Sie unter **[ENVIRONMENT.md](https://github.com/awaku7/agentcli/blob/main/ENVIRONMENT.md)**.
## Hauptmerkmale
- **Praktisches Toolset**: Ausgestattet mit Werkzeugen für Dateimanipulation, Websuche, Datenextraktion (PDF/PPTX/Excel), Bildgenerierung und -analyse, die alle in Ihrer lokalen Umgebung ausgeführt werden können.
- **Unterstützung mehrerer Anbieter**: Unterstützt OpenAI / Azure / Bedrock / OpenRouter / Ollama / Gemini / Vertex AI / Claude / Grok / NVIDIA.
- **Flexible Schnittstellen**:
- **CLI**: `uag` / `python -m uagent`
- **GUI**: `uagg` / `python -m uagent.gui`
- **Web**: `uagw` / `python -m uagent.web`
- **MCP (Model Context Protocol)**: Unterstützung für die Verbindung zu externen MCP-Tool-Servern.
- **Sitzungskontinuität**: Beibehalten des Konversationskontexts auch beim Wechsel von Anbietern oder Modellen.
- **Web Inspector**: Automatisches Speichern von Browser-Übergängen, DOM und Screenshots mit `playwright_inspector`.
- **Integrierte Dokumentation**: Sofortiger Zugriff auf detaillierte interne Dokumentation mit dem Befehl `uag docs`.
## Nutzung
### Starten und Beenden
Führen Sie `uag` in Ihrem Terminal aus, um zu starten. Geben Sie `:exit` ein, um das Programm zu beenden.
### A2A (Agent2Agent) Server
Sie können einen A2A-kompatiblen HTTP-Server separat von den bestehenden Schnittstellen starten.
```bash
uaga
# oder python -m uagent.a2a.server
```
### Praktische Tipps (Kontinuität und Kontrolle)
- `:tools`: Liste der geladenen Tools anzeigen.
- `:logs [n]`: Sitzungsprotokolle anzeigen (`n` zur Angabe der Anzahl der Einträge).
- `:load `: Eine vergangene Sitzung laden, um die Konversation fortzusetzen.
- `:skills`: Agent Skills (zusätzliche Rollen oder Anweisungen) auswählen und laden.
- `:shrink [n]`: Verlauf organisieren, um nur die letzten `n` Nachrichten zu behalten und Token zu sparen.
## Konfiguration und Details
### Umgebungsvariablen und Einrichtung
Detaillierte Einstellungen (API-Schlüssel, Anzeigesprache `UAGENT_LANG`, Verlaufsschrumpf-Einstellungen usw.) finden Sie unter **[ENVIRONMENT.md](https://github.com/awaku7/agentcli/blob/main/ENVIRONMENT.md)**.
- **Setup**: Interaktiv über `python -m uagent.setup_cli` konfigurieren.
- **Verschlüsselung**: Verschlüsseln Sie Ihre `.env`-Datei sicher mit dem Tool `uag_envsec`.
### Entwickler und Internationalisierung
- **Entwickler-Dokumentation**: [`src/uagent/docs/DEVELOP.md`](https://github.com/awaku7/agentcli/blob/main/src/uagent/docs/DEVELOP.md)
- **Hinzufügen von Gebietsschemata**: [`src/uagent/docs/ADD_LOCALE.md`](https://github.com/awaku7/agentcli/blob/main/src/uagent/docs/ADD_LOCALE.md)
- **README in anderen Sprachen**: [English](https://github.com/awaku7/agentcli/blob/main/README.md) / [日本語](https://github.com/awaku7/agentcli/blob/main/README.ja.md) / [Deutsch](https://github.com/awaku7/agentcli/blob/main/README.de.md) / [Español](https://github.com/awaku7/agentcli/blob/main/README.es.md) / [Français](https://github.com/awaku7/agentcli/blob/main/README.fr.md) / [Italiano](https://github.com/awaku7/agentcli/blob/main/README.it.md) / [한국어](https://github.com/awaku7/agentcli/blob/main/README.ko.md) / [Português](https://github.com/awaku7/agentcli/blob/main/README.pt_BR.md) / [Русский](https://github.com/awaku7/agentcli/blob/main/README.ru.md) / [ไทย](https://github.com/awaku7/agentcli/blob/main/README.th.md) / [简体中文](https://github.com/awaku7/agentcli/blob/main/README.zh_CN.md) / [繁體中文](https://github.com/awaku7/agentcli/blob/main/README.zh_TW.md)