# Na czym działa Maguyva Canonical source: https://maguyva.ai/pl/stack License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license). Zbudowana z myślą o szybkości, łatwości debugowania i ciągłym doskonaleniu: sprawdzona infrastruktura u podstaw, dedykowane komponenty tam, gdzie wymaga tego inteligencja kodu. - PostgreSQL + Lance - Skwantyzowane wyszukiwanie wektorowe - Silnik językowy kodu - MCP wszędzie - 285+ języków ## Co działa na produkcji To są kluczowe warstwy, które przetrwały wiele iteracji. Każda z nich zasłużyła na swoje miejsce, ułatwiając debugowanie albo usuwając tarcia w pracy agentów. ### PostgreSQL + Lance *Baza danych* Dane i indeksy podzielone według tenantów. Twój kod pozostaje odizolowany, bez mieszania indeksów między użytkownikami. ### Voyage AI: voyage-4-large *Embeddingi* Embeddingi kodu zapewniające wysoką kompletność wyników do wyszukiwania, pobierania danych i ugruntowywania odpowiedzi agentów. ### Binary Quantized HNSW *Wyszukiwanie wektorowe* Embeddingi skompresowane do 2048-bitowych sygnatur i zaindeksowane za pomocą HNSW. 32-krotna redukcja miejsca, wyszukiwanie o niskim opóźnieniu, zero dodatkowej infrastruktury. ### Silnik językowy kodu *Silnik językowy* Mocno zmodyfikowany stos Tree-sitter z niestandardowymi gramatykami, heurystykami obsługi i pokryciem ekstrakcji dla 285 języków ### Protokół MCP *Protokół* Zdalny serwer MCP. Obsługiwane aplikacje klienckie: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop i inni klienci zgodni z MCP. Liczba narzędzi: 11. Serwer działa na Cloudflare Worker w TypeScript z natywnym transportem streamable HTTP. ### Lance kolumnowy + R2 *Pamięć podręczna* Embeddingi z buforowaniem kolumnowym, synchronizowane w chmurze ## Stos po ślepych zaułkach Maguyva nie osiągnęła tego kształtu od razu. Każda warstwa przetrwała, bo sprawiała, że system był łatwiejszy do zrozumienia, tańszy w utrzymaniu albo łatwiejszy do debugowania pod presją. Eksperymenty z orkiestracją zaczęły się wcześniej. Ta oś czasu zaczyna się we wrześniu 2025 roku, gdy sam produkt Maguyva nabrał ostrego kształtu. - **2025-Q3** (fundament): Skoncentrowana budowa Maguyva startuje → Voyage voyage-code-3. Kierunek produktu się krystalizuje i zaczyna się pętla szybkiej iteracji - **2025-Q3** (przechowywanie): Warstwa binarnego wyszukiwania wektorowego. Skwantyzowane wyszukiwanie z kompaktowymi indeksami, bez osobnego stosu wektorowego - **2025-Q4** (silnik-ast): Silnik językowy kodu wchodzi do użytku. Niestandardowe zapytania, zapasowe parsery i heurystyki oparte na handlerach w 285 językach - **2025-Q4** (wyszukiwanie): Wieloaspektowe wyszukiwanie fuzyjne. Rankingowe pobieranie danych z indeksów semantycznych, tekstowych, AST i grafowych w jednym zapytaniu - **2026-Q1** (buforowanie): Lance kolumnowy + synchronizacja R2. Kolumnowy cache po stronie serwera, szybsze uruchomienia na zimno - **2026-Q1** (jakość): Framework walidacji dla 285 języków. Automatyczne testowanie ekstrakcji we wszystkich obsługiwanych językach - **2026-Q1** (premiera): Publiczna premiera na maguyva.ai. 7 miesięcy od skoncentrowanej budowy do publicznej dostępności - **2026-Q2** (protokół): Usługa MCP na Cloudflare Worker w TypeScript. Natywny transport streamable HTTP, mniejsze opóźnienia, migracja podczas obsługi ruchu produkcyjnego - **NOW** (embeddingi): Embeddingi w środowisku produkcyjnym → voyage-4-large. Wyszukiwanie semantyczne o wyższej kompletności wyników po migracji z voyage-code-3 ## Działamy na tym, co wydajemy Maguyva jest budowana przez agentów, którzy działają na Maguyva. Nasz system orkiestracji koordynuje wyspecjalizowanych agentów AI, którzy korzystają z tych samych narzędzi MCP, indeksów wyszukiwania i infrastruktury produkcyjnej, co Ty. Nie ma żadnej wewnętrznej wersji. Strona zespołu wymienia “1x Maguyva ($149) — płacimy sami sobie.” To nie żart. To faktura. // klient zero wdraża na produkcję codziennie ## Zasady, które przetrwały produkcję To są ograniczenia, które pozostały użyteczne na produkcji. Chodzi w nich mniej o ideologię, a bardziej o to, żeby system był zrozumiały, gdy agenci wprowadzają zmiany w dużym tempie. ### Zero cichych fallbacków Szybko zgłaszaj błędy, szybko je naprawiaj. Każdy błąd ujawnia się natychmiast. Żadnego stopniowego ograniczania funkcjonalności, które ukrywa błędy na produkcji. *// awaryjne zakończenie > ciche uszkodzenie danych* ### Najpierw RPC Logika po stronie bazy danych dla wydajności. Funkcje PostgreSQL wykonują się blisko danych, eliminując zbędne rundy komunikacji sieciowej. *// funkcje PostgreSQL, 0 ORM-ów* ### CQRS Oddzielne ścieżki zapisu i odczytu. Pipeline indeksujący zapisuje, narzędzia MCP odczytują. Różne strategie optymalizacji. *// zapisy: wsadowo | odczyty: z cache* ### Deterministyczne UUID Spójność pamięci podręcznej bez odpytywania bazy danych. Te same dane wejściowe = to samo ID. Operacje idempotentne z założenia. *// uuid5(namespace, content_hash)* Najlepsza architektura to taka, którą można debugować o 3 nad ranem. (Sprawdziliśmy to.) // ostatnia aktualizacja: 2026-10 [Wypróbuj na swoim repozytorium](https://app.maguyva.ai/auth/sign-up?plan=free) ## Gdzie mieszka Twój kod Żadnej tajemnicy. Oto dokładnie, co dzieje się z Twoim kodem, gdy podłączasz repozytorium. - **Serwery bare-metal, US East** (Obliczenia): Maszyny bare-metal w Ashburn, dostrojone pod przepustowość indeksowania zamiast instancji ogólnego przeznaczenia ze współdzielonymi, obciążonymi zasobami. - **Globalny CDN Cloudflare** (Edge): Odpowiedzi API i MCP buforowane na brzegu sieci (edge). Zasoby statyczne serwowane z globalnej sieci Cloudflare. - **Podział na najemców dla każdego workspace** (Izolacja): Każdy workspace otrzymuje indeksy repozytoriów ograniczone do danego najemcy w całym pipeline i bazie danych. Kod klientów wykorzystujemy do dostarczania inteligencji kodu, a nie do trenowania modeli czy sprzedaży danych. - **Zarejestrowana w Singapurze** (Podmiot): UT International PTE. LTD. Prawdziwa jurysdykcja, prawdziwy podmiot. - **Usuń repozytorium, usuń indeks** (Usunięcie): Odłącz repozytorium, a Maguyva usunie z usługi aktywnie zaindeksowany kod źródłowy, embeddingi i dane grafowe. Pozostałe kopie zapasowe wygasają zgodnie z harmonogramem retencji. - **Potrzebujesz UE lub AU?** (Regiony): Dodatkowe regiony wdrożenia to temat do rozmowy dla klientów z wymaganiami dotyczącymi lokalizacji danych. ## Kolejne kroki - [Zacznij teraz](https://maguyva.ai/pl/docs): Zaindeksuj swoje pierwsze repo w kilka minut. - [Zobacz cennik](https://maguyva.ai/pl/pricing): Opłata za workspace, nie za użytkownika. Zacznij za darmo. - [Poznaj zespół](https://maguyva.ai/pl/team): 2 ludzi i rój agentów AI. - [Przeczytaj bloga](https://maguyva.ai/pl/blog): Notatki techniczne z budowy.