🏔️ Carpați AI — Agent Inteligența Artificială pentru România

Agent AI personal și business, creat pentru piața românească. Rulează local, vorbește românește, se integrează cu servicii românești.

🧬 ADN

| Părinte | Ce moștenim | |---|---| | OpenClaw | Gateway, canale (WhatsApp/Telegram/Discord), Voice, Mobile Nodes | | Hermes | Skills engine, Mem0 memory, Session search, Subagents, Python execution |

📦 Instalare

Cerințe

• Node.js ≥ 18
• Python ≥ 3.11
• npm (vine cu Node.js)

Instalare globală (recomandat)

npm install -g carpati-ai

După instalare, comanda carpati devine disponibilă global:

carpati --help

Instalare din repo

git clone https://github.com/serverul/carpati-ai.git
cd carpati-ai
npm link                # face carpati disponibil global
npm install             # instalează dependențe Node.js
pip install -r requirements.txt   # instalează dependențe Python

Docker (1-click)

git clone https://github.com/serverul/carpati-ai.git
cd carpati-ai
docker compose up -d

🚀 Quick Start

# 1. Configurare inițială
carpati setup

# 2. Adaugă un provider LLM
carpati provider add deepseek https://api.deepseek.com/v1 sk-cheia-ta
carpati provider use deepseek

# 3. Pornește engine-ul
carpati start

# 4. Deschide WebChat
carpati chat
# sau direct în browser: http://localhost:5001

Cu cheie DeepSeek (recomandat)

export DEEPSEEK_API_KEY=sk-cheia-ta
carpati start

Cu Ollama local

# Asigură-te că Ollama rulează
ollama serve

# Adaugă provider-ul
carpati provider add ollama http://localhost:11434/v1 ""
carpati provider use ollama

# Pornește
carpati start

📋 CLI Reference

carpati
├── start                        Pornește engine-ul + WebChat UI
├── stop                         Oprește engine-ul
├── status                       Status engine + canale
├── chat                         Deschide WebChat în browser
│
├── config                       Gestionare configurație
│   ├── list                     Afișează toată configurația
│   ├── get <cheie>              Citește o valoare
│   ├── set <cheie> <valoare>    Setează o valoare
│   └── path                     Arată calea fișierului de config
│
├── provider                     Gestionare provideri LLM
│   ├── list                     Listați providerii
│   ├── add <nume> <url> <key>   Adaugă provider
│   ├── remove <nume>            Șterge provider
│   ├── use <nume>               Setează provider implicit
│   └── test <nume>              Testează conexiunea
│
├── channels                     Gestionare canale
│   ├── list                     Canale configurate
│   ├── add <canal>              Adaugă canal (whatsapp|telegram|discord|web)
│   ├── remove <canal>           Șterge canal
│   └── status                   Status conectivitate
│
├── models                       Descoperire modele
│   ├── list                     Modele disponibile
│   ├── scan                     Scanează modele locale (Ollama)
│   └── use <model>              Setează model implicit
│
├── setup                        Wizard interactiv de configurare
├── doctor                       Verificări de diagnosticare (8 checks)
├── tui                          Dashboard terminal interactiv
└── help [comandă]               Ajutor general sau per comandă

Exemple rapide

# Vezi tot ce e configurat
carpati config list

# Schimbă provider-ul pe Ollama
carpati provider use ollama

# Testează conexiunea la DeepSeek
carpati provider test deepseek

# Vezi ce modele ai pe Ollama local
carpati models scan

# Adaugă canal Telegram
carpati channels add telegram

# Diagnosticare completă
carpati doctor

# Dashboard terminal
carpati tui

🖥️ TUI (Terminal UI)

Dashboard interactiv în terminal:

carpati tui

Afișează în timp real:

• Status engine (online/offline)
• Canale active
• Ultimele activități
• Provideri și modele

Comenzi în TUI:

• q — ieșire
• r — reîmprospătare manuală
• s — pornește/oprește engine-ul

🏗️ Structură

carpati-ai/
├── bin/
│   ├── carpati.js      # CLI principal (1600+ linii, zero deps)
│   └── tui.js          # Terminal UI dashboard
├── engine/             # Python — AI engine
│   ├── __init__.py     # Agent principal (think → execute → respond)
│   ├── main.py         # Server HTTP (WebChat + API)
│   ├── skills/         # 159 skills auto-loading
│   ├── memory/         # Mem0 + file_store + session search
│   ├── tools/          # 7 tools: terminal, files, web, code
│   ├── providers/      # DeepSeek, Ollama, OpenAI + failover
│   └── integrations/   # ANAF, SmartBill, FAN Courier, MobilPay
├── gateway/            # Node.js — WebSocket Gateway (viitor)
└── docker-compose.yml  # Deployment 1-click

🔧 Configurare avansată

Fișierul de configurare

Locație: ~/.carpati/config.json

{
  "version": "0.2.0",
  "provider": "deepseek",
  "model": "deepseek-chat",
  "port": 5001,
  "language": "ro",
  "channels": ["web"],
  "providers": {
    "deepseek": {
      "url": "https://api.deepseek.com/v1",
      "key": ""
    },
    "ollama": {
      "url": "http://localhost:11434/v1",
      "key": ""
    }
  }
}

Variabile de mediu

| Variabilă | Descriere | Implicit | |---|---|---| | DEEPSEEK_API_KEY | Cheie API DeepSeek | — | | OLLAMA_HOST | Host Ollama | http://localhost:11434 | | CARPATI_PORT | Port engine | 5001 |

🧪 Testare

# Verifică sănătatea
carpati doctor

# Testează engine-ul
carpati start
curl http://localhost:5001/health

# Testează chat-ul
curl -X POST http://localhost:5001/chat \
  -H "Content-Type: application/json" \
  -d '{"session_id":"test","user_id":"eu","channel":"web","message":"Salut!"}'

💰 Prețuri (planificat)

| Plan | Preț (RON/lună) | Canale | Integrări | Suport | |---|---|---|---|---| | Micro | 49 | 1 | — | Community | | Pro | 199 | 5 | Facturi, Curier, Plăți | Email | | Enterprise | 499 | Nelimitat | Custom + On-premise | Prioritar 24/7 |

🌍 Integrări planificate

• 📄 ANAF — e-Factura, D112, SPV
• 📊 SmartBill / SAGA — Contabilitate
• 📦 FAN Courier / Sameday — Curierat
• 💳 Netopia / MobilPay — Plăți
• 📅 Calendra — Programări online
• 💼 eJobs / BestJobs — Recrutare
• 📱 WhatsApp Business API — #1 canal în România

🔧 Tech Stack

• Runtime: Node.js ≥18 (CLI) + Python 3.11+ (engine)
• LLM Default: DeepSeek-V3 (cel mai bun raport calitate/preț)
• LLM Local: Gemma 4 9B (rulează pe RPi 5)
• Memory: Mem0 (vector) + file_store (JSON)
• Tools: terminal, files, web_search, web_extract, code execution
• Deployment: Docker Compose (1-click) sau bare-metal
• Dependențe externe: zero (CLI folosește doar Node.js built-ins)

📅 Roadmap

• [x] Research & Analiză OpenClaw vs Hermes
• [x] Engine Python complet (agent loop, skills, memory, tools)
• [x] CLI complet (config, provider, channels, models, doctor, tui)
• [x] WebChat UI funcțional
• [ ] Canale reale: WhatsApp (Baileys), Telegram (grammY)
• [ ] Integrări RO: ANAF, SmartBill, FAN Courier
• [ ] RPi 5 deployment image
• [ ] Landing page + docs RO
• [ ] Beta cu clienți reali

📜 Licență

MIT © 2026 Carpați AI