Agent Basia 1.2

Modularny, produkcyjny agent AI — wersja webowa

🚀 Funkcje

• nowoczesny interfejs czatu (mobile + desktop),
• backend oparty o OpenAI API (odpowiedzi + embeddingi),
• pełne HTTPS (Let’s Encrypt + globalny nginx),
• routing /api/chat → backend,
• wektorowy system pamięci (RAG),
• modularna struktura gotowa pod rozbudowę,
• wdrożenie w jednym poleceniu (docker compose up -d).

📂 Struktura projektu

agent-Basia/
│
├── backend/                     # Logika API Agi (Node.js + OpenAI + RAG)
│   ├── server.js                # Główny serwer backendu
│   ├── rag.js                   # Wektorowy system pamięci
│   ├── package.json
│   └── ...
│
├── frontend/                    # Interfejs webowy (chat)
│   └── chat/                    # Główny frontend produkcyjny
│       ├── index.html
│       ├── style.css
│       ├── script.js
│       ├── assets/
│       │   └── agent-Basia.png
│       └── readme.html          # Lokalna dokumentacja
│
├── memory/                      # Pliki indeksowane przez RAG
│
├── docker-compose.yml           # Orkiestracja backendu + nginx + certbot
│
├── nginx/                       # Konfiguracja nginx
│   └── default.conf
│
├── certs/                       # Certbot (live/archive/accounts)
│
├── LICENSE                      # Licencja projektu
├── README.md                    # Dokumentacja główna
└── INSTALL.md                   # Instrukcja instalacji

🧠 Jak działa Agent Basia?

Frontend

• statyczny interfejs czatu,
• serwowany przez globalny nginx,
• komunikacja z backendem przez fetch("/api/chat"),
• responsywny layout.

Backend

• endpoint: POST /api/chat,
• integracja z OpenAI (odpowiedzi + embeddingi),
• moduł RAG: indeksowanie dokumentów i wyszukiwanie wektorowe,
• zwracanie odpowiedzi w JSON,
• przygotowany pod pamięć trwałą i pluginy.

Globalny Nginx

• obsługuje HTTPS (Let’s Encrypt),
• redirect HTTP → HTTPS,
• serwuje frontend,
• proxy /api/chat → Basia-backend:3000.

Certbot

• generowanie certyfikatów,
• automatyczne odnawianie,
• integracja z globalnym nginx.

🧱 Roadmapa

1.2 — RAG (zrealizowane)

• wektorowy system pamięci,
• indeksowanie dokumentów,
• kontekst zewnętrzny.

1.3 — Integracje API

• Gmail,
• Calendar,
• pluginy REST,
• pamięć trwała konwersacji.

📄 Licencja

Copyright (c) 2026
Jarek Putaj — https://ai-api.pl

All rights reserved.

Niniejsze oprogramowanie jest przeznaczone wyłącznie do użytku prywatnego.
Zabrania się kopiowania, modyfikowania, udostępniania, sprzedawania lub wykorzystywania kodu w całości lub w części bez wyraźnej zgody autora.

Kod źródłowy, dokumentacja oraz wszystkie pliki zawarte w tym repozytorium stanowią własność intelektualną Jarka Putaja.

Wszelkie prawa zastrzeżone.