# askdare: Czat AI na stronę, w jednej linijce

Adres: https://sebastianmusial.pl/realizacje/askdare/ · Strona klienta: https://askdare.vercel.app/

askdare to moja biblioteka: wymyśliłem ją, zaprojektowałem i napisałem od pierwszej linijki. Dzięki niej firma wstawia na stronę jedną linijką kodu czat AI, który odpowiada z jej dokumentów.

- Typ: Biblioteka open source · MIT
- Rola: Twórca i maintainer · Boldare
- Technologia: Next.js, TypeScript, OpenAI API
- Kod: <a class="link" href="https://github.com/boldare/askdare" target="_blank" rel="noopener">GitHub</a> · <a class="link" href="https://www.npmjs.com/package/@boldare/askdare" target="_blank" rel="noopener">npm</a>

## Wyzwanie: Koniec API, koniec czatów.

Moja wcześniejsza biblioteka do asystentów AI stała na Assistants API, które OpenAI wycofało w 2026 roku. Programiści, którzy na niej zbudowali czaty, zostali bez wyjścia: łatanie starego kodu nie miało sensu.

Do tego czat na stronie to publiczne miejsce, w którym każdy może pisać do modelu na koszt właściciela. Bez limitów jedna noc nadużyć zamienia się w fakturę, a odpowiedź modelu wyświetlana na cudzej stronie musi być bezpieczna.

## Co zrobiłem.

- **Jedna linijka na stronie.** Czat trafia na dowolną stronę, także spoza Next.js, jednym tagiem `<script>`. Na każdej podstronie ładuje się ok. 3 KB, a reszta dopiero po kliknięciu.
- **Odpowiedzi z dokumentów firmy.** Folder z dokumentami trafia do bazy wiedzy jednym poleceniem, a każda odpowiedź podaje źródła jako linki do stron firmy. Czat może też sprawdzić zamówienie albo cenę przez własne narzędzia.
- **Koszty pod kontrolą.** Dzienne budżety tokenów na bota i na adres IP, limity wiadomości, wyłącznik awaryjny. Zagrożenia opisałem w osobnym modelu zagrożeń, opartym na OWASP dla aplikacji z LLM.
- **Dostępny dla każdego.** Cztery motywy, jasny i ciemny, jeden z kontrastem AAA. Każde wydanie przechodzi automatyczny test dostępności, a czytniki ekranu sprawdzam ręcznie.
- **Od zera do czatu w 15 minut.** Polecenie `init` zakłada wszystko, czego potrzeba. Bez bazy danych: rozmowy trzyma OpenAI, a wdrożenie wymaga dwóch zmiennych środowiskowych.
- **Decyzje na piśmie.** 12 zapisanych decyzji architektonicznych, dokumentacja w paczce zgodna z zainstalowaną wersją i przewodnik migracji ze starej biblioteki.

## Efekt. Bierz i używaj.

Biblioteka jest w npm na licencji MIT, z działającym demo i dokumentacją, w której odpowiada sam czat. Każde wydanie przechodzi ok. 400 testów i testy w trzech przeglądarkach, zanim trafi do ludzi.

- 3 KB: skryptu na stronie, reszta po kliknięciu
- 15 min: od instalacji do działającego czatu
- ~400: testów automatycznych
- 3: przeglądarki w każdym wydaniu

Usługi: [Automatyzacje AI](https://sebastianmusial.pl/oferta/automatyzacje-ai/), [Programista do zespołu](https://sebastianmusial.pl/oferta/programista-b2b/)

---

Zaktualizowano: 2026-11-11. Sebastian Musiał, kontakt@sebastianmusial.pl, rozmowa 30 min: https://calendly.com/sebastianmusial/30min. Wycena po rozmowie, bez cennika na stronie.
Spis wszystkich stron: https://sebastianmusial.pl/llms.txt · Cała treść w jednym pliku: https://sebastianmusial.pl/llms-full.txt