AG064/argentum

Was macht argentum?

Modulares KI-Agenten-Framework mit 59 einsteckbaren Funktionen, 8+ Nachrichtenkanälen und produktionsreifer Sicherheit. TypeScript-first. MIT-Lizenz. Selbst gehostet, keine Abonnements.

Übersicht

Argentum ist ein leistungsstarkes, modulares Framework zur Erstellung von KI-Agenten. Es wurde mit Fokus auf Erweiterbarkeit, Sicherheit und Eigenständigkeit entwickelt. Im Gegensatz zu vielen Cloud-basierten Diensten läuft Argentum vollständig auf Ihrer eigenen Infrastruktur – keine Abonnements, keine externen Abhängigkeiten für die Laufzeitumgebung.

Hauptmerkmale

• 59+ einsteckbare Funktionen – Von natürlicher Sprachverarbeitung über Befehlshandhabung bis hin zu Datenbankintegrationen.
• 8+ Nachrichtenkanäle – Discord, Slack, Telegram, WebSocket, E-Mail, Matrix, WhatsApp und mehr.
• TypeScript-first – Vollständig in TypeScript geschrieben mit erstklassigen Typdefinitionen.
• Produktionsreife Sicherheit – Role-based Access Control, verschlüsselte Konfiguration, Audit-Logs.
• Selbst gehostet – Keine versteckten Kosten, volle Datenkontrolle.
• MIT-Lizenz – Frei für kommerzielle und private Nutzung.

Unterstützte Plattformen

Plattform	Kanal	Status
Discord	Bot	Stabil
Slack	Bot	Stabil
Telegram	Bot	Stabil
Web	WebSocket/REST	Stabil
E-Mail	IMAP/SMTP	Beta
Matrix	Bridge	Beta
WhatsApp	Business API	Experimentell

Erste Schritte

Voraussetzungen

• Node.js 18+ (LTS empfohlen)
• npm oder yarn
• Git
• (Optional) Docker für Container-Bereitstellung

Installation

# Klonen des Repos
git clone https://github.com/AG064/argentum.git
cd argentum

# Abhängigkeiten installieren
npm install

# Konfiguration kopieren
cp .env.example .env
# Bearbeiten Sie die .env-Datei mit Ihren API-Schlüsseln und Kanaleinstellungen

# Build erstellen
npm run build

# Starten
npm start

Konfiguration

Die Hauptkonfiguration erfolgt über die .env-Datei oder Umgebungsvariablen. Wichtige Einstellungen:

• ARGENTUM_LLM_PROVIDER: LLM-Anbieter (z. B. openai, anthropic, ollama)
• ARGENTUM_CHANNELS: Aktivierte Kanäle (kommagetrennt, z. B. discord,slack,telegram)
• ARGENTUM_PLUGINS: Aktivierte Plugins (kommagetrennt)
• ARGENTUM_LOG_LEVEL: Loglevel (debug, info, warn, error)

Plugins aktivieren

Plugins sind als separate npm-Pakete oder lokale Module verfügbar. Beispiel:

// argentum.config.ts
import { defineConfig } from '@argentum/core';

export default defineConfig({
  plugins: [
    '@argentum/plugin-openai',
    '@argentum/plugin-web-search',
    '@argentum/plugin-cron',
  ],
});

API-Nutzung

Argentum bietet eine REST-API und WebSocket-Schnittstelle für die externe Steuerung.

REST-API

# Agenten-Nachricht senden
curl -X POST http://localhost:3000/api/message \
  -H "Content-Type: application/json" \
  -d '{"channel": "web", "text": "Hallo, Argentum!", "userId": "user-1"}'

WebSocket

const ws = new WebSocket('ws://localhost:3000/ws');
ws.onopen = () => ws.send(JSON.stringify({ type: 'message', payload: { text: 'Hallo!' } }));
ws.onmessage = (event) => console.log(JSON.parse(event.data));

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert. Siehe LICENSE für Details.