Opis projektu

Local AI Companion to aplikacja webowa łącząca interfejs czatu, backend API oraz syntezę mowy. Użytkownik może pisać wiadomości, korzystać z wejścia głosowego dostępnego w przeglądarce, edytować ustawienia agenta i odsłuchiwać wygenerowane odpowiedzi.

Projekt jest zbudowany jako lokalne MVP. Backend odpowiada za komunikację z dostawcą AI, budowanie promptu systemowego, obsługę krótkiej pamięci rozmowy i generowanie plików audio. Frontend pozostaje niezależny od tego, czy odpowiedź pochodzi z Ollama, czy z OpenAI.

Zrzuty ekranu

Wykorzystane technologie

Aktualny zakres MVP

• Czat tekstowy z agentem AI.
• Konfiguracja imienia, roli, osobowości, tonu i stylu odpowiedzi.
• Krótka pamięć rozmowy przechowywana w procesie backendu.
• Przełącznik krótkich i bardziej szczegółowych odpowiedzi.
• Opcjonalne generowanie odpowiedzi głosowych przez lokalny Piper CLI.
• Prosty panel ustawień oraz tryb jasny i ciemny interfejsu.

Możliwy dalszy rozwój

• Trwała pamięć użytkownika zapisywana w bazie danych.
• Obsługa wielu agentów o różnych rolach i zestawach reguł.
• Lepsza personalizacja głosu, wyboru modeli i parametrów odpowiedzi.
• Panel administracyjny do zarządzania konfiguracją i historią rozmów.
• Autoryzacja użytkowników oraz separacja danych między kontami.
• Integracje z dokumentami, bazami wiedzy, CRM lub narzędziami firmowymi.
• Testy frontendowe, monitoring działania oraz gotowy tryb wdrożeniowy.

Potencjalny cel biznesowy

Projekt może być rozwijany jako baza dla prywatnego asystenta, firmowego konsultanta, cyfrowego recepcjonisty lub narzędzia wspierającego obsługę klienta. Dzięki lokalnemu trybowi pracy i kontroli nad dostawcą AI aplikacja może być użyteczna tam, gdzie ważna jest prywatność danych, personalizacja komunikacji i możliwość integracji z wewnętrznymi procesami organizacji.

Project Description

Local AI Companion is a web application that combines a chat interface, backend API, and speech synthesis. The user can send text messages, use browser-based voice input, edit the assistant's behavior settings, and replay generated voice responses.

The project is built as a local MVP. The backend handles AI provider communication, system prompt construction, short conversation memory, and audio file generation. The frontend stays independent from whether the response is generated by Ollama or OpenAI.

Screenshots

Technologies Used

Current MVP Scope

• Text chat with an AI agent.
• Configurable name, role, personality, tone, and response style.
• Short conversation memory kept in the backend process.
• Switch between concise and more detailed responses.
• Optional voice response generation with local Piper CLI.
• Simple settings panel plus light and dark interface themes.

Possible Future Development

• Persistent user memory stored in a database.
• Support for multiple agents with different roles and rules.
• Better customization of voices, models, and response parameters.
• Admin panel for configuration and conversation history management.
• User authentication and account-level data separation.
• Integrations with documents, knowledge bases, CRM, or internal tools.
• Frontend tests, monitoring, and a production-ready deployment mode.

Potential Business Goal

The project can become a foundation for a private assistant, company consultant, digital receptionist, or customer support tool. With local execution options and backend-controlled AI provider selection, it can be useful in environments where data privacy, communication personalization, and integration with internal business workflows are important.