AiHummer
Română▾
Autentificare
v1.0.x▾
v1.0.xstable
{ }Swagger
Primii pași/Quickstart

Quickstart

v1.0.x · actualizat 2026-07-07

Acest quickstart parcurge prima rulare a AiHummer — de la instalare la un prim agent care răspunde într-un canal. Fiecare pas are o pagină dedicată cu detalii complete, legată pe parcurs.

Instalează AiHummer

Instalarea începe în contul personal: înregistrează-te pe my.aihummer.ru, deschide ecranul „Instalare” și obține linkul personal de instalare. Contul îți va afișa comanda gata pregătită — rulează-o pe server cu sudo (instalarea fără root este de asemenea suportată — vezi Instalare):

curl -fsSL "<link personal de instalare>" | sudo bash

Installer-ul detectează arhitectura ta, descarcă și verifică bundle-ul semnat, dispune rădăcina de instalare și înregistrează serviciul gateway sub systemd. Pentru detaliile complete — linkul personal, canale de release, alegerea sidecars-urilor, verificarea — vezi Instalare.

Îndreaptă către PostgreSQL

Singura dependență dură este PostgreSQL cu extensia pgcrypto activată. Installer-ul cablează conexiunea la baza de date automat. Dacă setezi baza de date manual, folosește opțiunea de configurare AIHUMMER_DATABASE_URL:

AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer?sslmode=disable
-- once, in the target database
CREATE EXTENSION IF NOT EXISTS pgcrypto;

Migrările de bază de date sunt aplicate automat la pornire.

Deschide interfața de administrare

Odată ce serviciul este pornit, deschide interfața de administrare pe server:

http://localhost:8781/

Pe o bază de date goală este tipărită o parolă de administrator de unică folosință. Vezi Primul login pentru cum să o recuperezi și să o schimbi imediat.

Conectează primul tău canal

Din interfața de administrare, adaugă un canal astfel încât mesajele să poată ajunge la AiHummer:

  • Telegram — cel mai pregătit pentru producție conector cu care să începi.
  • Widget web — cel mai rapid mod de a testa totul într-un browser.
  • MAX — un messenger rusesc, de asemenea disponibil.

Creează primul tău agent

În interfața de administrare, creează un agent: dă-i o persona și, opțional, un model per agent. Leagă-l de canalul pe care tocmai l-ai adăugat (blocul „Bindings” de pe pagina „Canale”), astfel încât router-ul să știe unde să trimită mesaje. Trimite un mesaj prin canal și urmărește turul rulând de la cap la coadă.

Vorbește cu agentul direct din interfața de administrare

Un canal nu este obligatoriu pentru prima verificare: pe pagina „Sesiuni”, butonul „+ Sesiune nouă” deschide un dialog cu agentul direct în interfața de administrare. În composer poți atașa fișiere (imagini și documente — modelul primește textul extras), iar două comutatoare deasupra conversației activează afișarea costului tururilor și a output-ului instrumentelor — util ca să vezi ce a făcut agentul la fiecare pas.

[!TIP] Poți de asemenea conduce AiHummer direct prin API-ul său compatibil OpenAI, fără niciun canal:

POST /v1/chat/completions
Content-Type: application/json

{"model": "default", "messages": [{"role": "user", "content": "Hello"}]}

Setează "stream": true pentru streaming SSE.

Atenție la modelul mock

Până cablezi un model real, răspunsurile vin de la un mock determinist — util pentru validarea canalelor, rutării și agenților fără niciun cost de model.

[!NOTE] Un model real nu este niciodată necesar: AiHummer rulează pe endpoint-uri gratuite/locale compatibile OpenAI și pe un transport prin abonament Codex/ChatGPT. Pentru a conecta propriul tău furnizor (BYOK), setează opțiunile de configurare AIHUMMER_LLM_* — acest lucru este opțional. Vezi Cerințe.

Unde mergi mai departe