AiHummer este o platformă self-hosted de agenți AI pentru afaceri. Ingerează mesaje
de la canalele angajaților și clienților, rutează fiecare mesaj către agentul potrivit, rulează un
tur de apelare de funcții cu instrumente și memorie pe termen lung și livrează răspunsul
înapoi către canalul de origine — totul gestionat dintr-o interfață web de administrare și un
API compatibil OpenAI.
Este un produs complet, nu un framework sau un SDK. Un singur serviciu autonom
acționează atât ca plan de control, cât și ca motor de tururi, astfel încât un deployment tipic
este un singur serviciu plus PostgreSQL.
Ce primești
Orchestrare multi-agent cu sub-agenți și strategii de raționament
opționale (plan-steps, reflectare, dezbatere, best-of-N, auto-vindecare).
Agenți de prim rang cu persona, un prompt structurat și un model per agent.
Memorie pe termen lung (Einstein) — fapte extrase ca afirmații examinabile, apoi
promovate în memorie; reapelarea este împachetată într-un data-fence împotriva injecției de prompt.
Cunoștințe / RAG cu citări, plus deep_research pentru rapoarte în mai mulți pași.
Canale — Telegram, MAX (un messenger rusesc, nou), Bitrix24 (IM intern
pentru angajați), telefonie SIP, un widget web încorporabil și o aplicație mobilă și desktop.
Un marketplace de pluginuri cu instalare nativă pe gazdă, dintr-un singur click.
Un vault criptat de credențiale, SSO enterprise (SAML / LDAP / SCIM / OIDC)
și Postgres Row-Level Security pentru izolare multitenant.
Cum curge un tur
Un canal livrează un mesaj primit către gateway.
Router-ul rezolvă agentul țintă prin bindings, @-mention-uri sau un fallback.
Orchestratorul asamblează un prompt de sistem stratificat, prietenos cu cache-ul, și
conduce o buclă de apelare de funcții peste instrumente integrate, sub-agenți și pluginuri.
Memoria și cunoștințele fundamentează răspunsul; ambele ajung ca rezultate de instrument, niciodată
ca instrucțiuni injectate.
Un outbox cu livrare garantată returnează răspunsul către canalul de origine.
Acestea nu sunt rânduri de marketing — fiecare pagină din acest ghid rămâne în interiorul lor.
Nativ pe gazdă, nu Docker. AiHummer se deployează ca un release tarball care rulează sub
systemd din /home/.aihummer. Nu există containere sau orchestratoare.
Fără modele plătite obligatorii. Rulează pe modele gratuite/locale și pe un
transport prin abonament Codex/ChatGPT. Cheile BYOK per tenant sunt opționale.
Securitatea ca proprietate de bază. Vault criptat cu plic, porți de aprobare cu om
în buclă, efecte secundare idempotente, data-fencing împotriva injecției de prompt, allowlist de IP
și audit.
Stabilitate. SemVer cu migrări de bază de date sigure pentru viitor, aplicate automat.
[!NOTE]
AiHummer expune un endpoint compatibil OpenAI POST /v1/chat/completions
(cu streaming SSE). El nu expune /v1/models sau /v1/embeddings,
iar observabilitatea este OTLP-push — nu există un endpoint Prometheus /metrics.
Pentru cine este
Companii care vor un angajat AI intern care răspunde personalului prin
Telegram sau Bitrix24, cu memorie, cunoștințe și porți de aprobare.
Echipe orientate către client care pun un agent pe un site web, o linie telefonică sau o
aplicație mobilă.
Deployment-uri conștiente de securitate, conformitate și suveranitate care au nevoie
de self-hosting, fără Docker, fără model extern plătit obligatoriu, secrete criptate,
izolare RLS și SSO.
Echipe de platformă și IT care vor un produs complet — interfață de administrare,
multitenancy, marketplace — în loc să asambleze un framework.
**AiHummer este o platformă self-hosted de agenți AI pentru afaceri.** Ingerează mesaje
de la canalele angajaților și clienților, rutează fiecare mesaj către agentul potrivit, rulează un
tur de apelare de funcții cu instrumente și memorie pe termen lung și livrează răspunsul
înapoi către canalul de origine — totul gestionat dintr-o interfață web de administrare și un
API compatibil OpenAI.
Este un **produs complet**, nu un framework sau un SDK. Un singur serviciu autonom
acționează atât ca plan de control, cât și ca motor de tururi, astfel încât un deployment tipic
este un singur serviciu plus PostgreSQL.
## Ce primești
- **Orchestrare multi-agent** cu sub-agenți și strategii de raționament
opționale (plan-steps, reflectare, dezbatere, best-of-N, auto-vindecare).
- **Agenți de prim rang** cu persona, un prompt structurat și un model per agent.
- **Memorie pe termen lung (Einstein)** — fapte extrase ca afirmații examinabile, apoi
promovate în memorie; reapelarea este împachetată într-un data-fence împotriva injecției de prompt.
- **Cunoștințe / RAG** cu citări, plus `deep_research` pentru rapoarte în mai mulți pași.
- **Canale** — Telegram, MAX (un messenger rusesc, nou), Bitrix24 (IM intern
pentru angajați), telefonie SIP, un widget web încorporabil și o aplicație mobilă și desktop.
- **Un marketplace de pluginuri** cu instalare nativă pe gazdă, dintr-un singur click.
- **Un vault criptat de credențiale**, SSO enterprise (SAML / LDAP / SCIM / OIDC)
și Postgres Row-Level Security pentru izolare multitenant.
## Cum curge un tur
1. Un **canal** livrează un mesaj primit către gateway.
2. **Router-ul** rezolvă agentul țintă prin bindings, `@`-mention-uri sau un fallback.
3. **Orchestratorul** asamblează un prompt de sistem stratificat, prietenos cu cache-ul, și
conduce o buclă de apelare de funcții peste instrumente integrate, sub-agenți și pluginuri.
4. **Memoria și cunoștințele** fundamentează răspunsul; ambele ajung ca rezultate de instrument, niciodată
ca instrucțiuni injectate.
5. Un **outbox** cu livrare garantată returnează răspunsul către canalul de origine.
```text
channel ─▶ router ─▶ orchestrator (tools · sub-agents · memory · RAG) ─▶ outbox ─▶ channel
```
## Principii fundamentale
Acestea nu sunt rânduri de marketing — fiecare pagină din acest ghid rămâne în interiorul lor.
- **Nativ pe gazdă, nu Docker.** AiHummer se deployează ca un release tarball care rulează sub
systemd din `/home/.aihummer`. Nu există containere sau orchestratoare.
- **Fără modele plătite obligatorii.** Rulează pe modele gratuite/locale și pe un
transport prin abonament Codex/ChatGPT. Cheile BYOK per tenant sunt opționale.
- **Securitatea ca proprietate de bază.** Vault criptat cu plic, porți de aprobare cu om
în buclă, efecte secundare idempotente, data-fencing împotriva injecției de prompt, allowlist de IP
și audit.
- **Stabilitate.** SemVer cu migrări de bază de date sigure pentru viitor, aplicate automat.
> [!NOTE]
> AiHummer expune un endpoint compatibil OpenAI `POST /v1/chat/completions`
> (cu streaming SSE). El **nu** expune `/v1/models` sau `/v1/embeddings`,
> iar observabilitatea este OTLP-push — nu există un endpoint Prometheus `/metrics`.
## Pentru cine este
- **Companii care vor un angajat AI intern** care răspunde personalului prin
Telegram sau Bitrix24, cu memorie, cunoștințe și porți de aprobare.
- **Echipe orientate către client** care pun un agent pe un site web, o linie telefonică sau o
aplicație mobilă.
- **Deployment-uri conștiente de securitate, conformitate și suveranitate** care au nevoie
de self-hosting, fără Docker, fără model extern plătit obligatoriu, secrete criptate,
izolare RLS și SSO.
- **Echipe de platformă și IT** care vor un produs complet — interfață de administrare,
multitenancy, marketplace — în loc să asambleze un framework.
## Unde mergi mai departe
- Nou aici? Continuă la [Cerințe](/en/v1.0/getting-started/requirements)
și [Instalare](/en/v1.0/getting-started/installation).
- Vrei mai întâi modelul mental? Citește
[Gateway și motor de tururi](/en/v1.0/architecture/gateway-turn-engine).
- Construiești față de API? Sari la
[chat/completions](/en/v1.0/api/chat-completions).