Powrót do strony głównej

Instalacja MindWander

Uwaga: Tylko dla zaawansowanych użytkowników

Rozszerzenie MindWander jest obecnie w fazie rozwoju i nie jest jeszcze dostępne do oficjalnej instalacji poprzez sklep Chrome Web Store. Poniższe instrukcje są przeznaczone dla programistów i zaawansowanych użytkowników, którzy chcą przetestować rozszerzenie w trybie deweloperskim.

Technologie

  • TypeScript
  • Chrome Extensions API (Manifest V3)
  • OpenAI API (domyślnie gpt-4o-mini)
  • Brave Search API

Wymagania

  • Node.js i npm
  • Przeglądarka oparta na Chromium (Chrome, Brave, Edge)
  • Klucz OpenAI
  • Klucz Brave Search

Kroki instalacji

  1. Sklonuj repozytorium:

    git clone https://github.com/PiotrSobiecki/MindWander.git cd MindWander

  2. Zainstaluj zależności:

    npm install

  3. Stwórz plik konfiguracyjny:

    cp src/config.ts_example.ts src/config.ts

  4. Edytuj src/config.ts i dodaj swoje klucze API:

    Plik src/config.ts jest w .gitignore — nie commituj kluczy. OPENAI_API_URL, BRAVE_API_URL i MODEL_AI zostaw jak w przykładzie, chyba że chcesz inny model OpenAI.

  5. Zbuduj rozszerzenie:

    npm run build

    Opcjonalnie: npm run test:apis — sprawdza klucze OpenAI i Brave Search.

  6. Zainstaluj rozszerzenie w przeglądarce:

    • Otwórz chrome://extensions/, brave://extensions/ lub edge://extensions/
    • Włącz „Tryb dewelopera”
    • Kliknij „Wczytaj rozpakowane”
    • Wybierz folder dist z repozytorium (nie src)

Użytkowanie

Po zainstalowaniu, MindWander działa w tle podczas przeglądania stron internetowych. Będzie analizować zawartość stron, a następnie prezentować inspirujące sugestie w formie dyskretnego popup'u w prawym dolnym rogu.

Każda sugestia zawiera:

  • Tytuł
  • Krótki opis wyjaśniający nieoczywisty związek z przeglądaną treścią
  • Link do źródła, które można otworzyć w nowej karcie

Rozwój

Aby pracować nad rozszerzeniem w trybie deweloperskim:

npm run watch

Po zmianach w TypeScript uruchom ponownie npm run copy-files lub pełne npm run build.

Kiedy będzie oficjalna wersja?

Pracujemy nad przygotowaniem rozszerzenia do publikacji w Chrome Web Store. Jeśli chcesz otrzymać powiadomienie, gdy oficjalna wersja będzie dostępna, skontaktuj się z nami na info@mind-wander.org.