SmallCode: agent kodujący dla lokalnych modeli AI

Q: Kiedy SmallCode pojawił się publicznie?

Pierwsze widoczne wydania, od v..x do v.., są datowane na – maja r. . Wpisy na Reddicie, które promowały projekt i deklarowany wynik %, pochodzą z maja r. . Dostępne źródła nie zawierają dowodów na

SmallCode to open-source'owy agent kodujący w terminalu dla lokalnych modeli 8B–35B. Co potrafi, skąd wynik 87% i jak wypada na tle Ollama i LM Studio.

Andrzej Niemiec

19 sierpnia 2026 · 6 min czytania · 1591 słów

Reviewed by Andrzej Niemiec

Czym jest SmallCode i dla kogo powstał?

SmallCode to agent kodujący działający w terminalu: czyta pliki projektu, planuje kroki i wywołuje narzędzia, opierając się na modelu uruchomionym lokalnie lub udostępnionym przez lokalny endpoint zgodny z OpenAI API. README rekomenduje modele 8B–35B i zaznacza, że modele do 4B mają problemy z wieloetapowym użyciem narzędzi [1].

Kod jest udostępniony na licencji MIT, a instalacja jest możliwa przez npm albo z wydań binarnych [1]. Za projektem stoi indywidualny autor — profil GitHuba identyfikuje go jako Tylera i opisuje jako „Just a random guy”, bez informacji o firmie, finansowaniu czy podmiocie gospodarczym [2]. Szerszy obraz lokalnych modeli AI, ich licencji i wymagań sprzętowych zbiera hub /lokalne-modele-ai.

Ma to praktyczne znaczenie: SmallCode nie jest alternatywą dla runtime'u modeli, tylko warstwą, która z takiego runtime'u korzysta. Jeśli nie masz jeszcze uruchomionego serwera z modelem, zaczniesz od Ollama, LM Studio lub llama.cpp, a SmallCode podłączysz do gotowego endpointu.

Kiedy SmallCode pojawił się publicznie?

Pierwsze widoczne wydania, od v0.9.x do v1.0.1, są datowane na 21–22 maja 2026 r. [3]. Wpisy na Reddicie, które promowały projekt i deklarowany wynik 87%, pochodzą z 18 maja 2026 r. [4][5]. Dostępne źródła nie zawierają dowodów na wcześniejszą, sięgającą 2024 r. historię projektu.

Stan na 31 maja 2026 r. repozytorium miało wersję v1.6.0, około 1,9 tys. gwiazdek, 141 forków i 24 wydania [1]. To metryki zmienne w czasie, więc przy każdym porównaniu trzeba podać datę pomiaru.

Deklarowany wynik 87% wymaga kontekstu. Repozytorium reklamuje go jako rezultat benchmarku z modelem o 4B aktywnych parametrów, ale nie podaje nazwy zestawu testowego ani pełnej metodologii [1]. Autor powtarza ten wynik w wpisach na Reddicie [4][5]. Nie jest to niezależnie zweryfikowany ranking — bardziej deklaracja autora niż pomiar porównawczy. Dlaczego pojedyncze benchmarki bywają mylące, opisuje tekst /posts/ranking-modeli-ai-open-source-dlaczego-benchmarki-to-za-malo.

Ile błędów naprawdę naprawiono?

Repozytorium nie podaje jednej sumy poprawek. Udokumentowane są konkretne serie: v1.2.1 opisuje siedem błędów integracji z dostawcami, v1.1.0 zamykała dwa zgłoszenia i zawierała poprawkę bezpieczeństwa, a v1.6.0 raportowała 313 przechodzących testów [3].

Krążąca w opisach projektu liczba 90 naprawionych błędów nie znajduje potwierdzenia w historii wydań [3]. W jednym z wpisów wydania pojawia się sformułowanie o dziesięciu poprawkach w stu przebiegach analizy — to inna wartość i inny kontekst [3]. Bezpieczniej opisywać projekt przez konkretne serie zmian niż przez jedną zaokrągloną liczbę.

Warto też oddzielić stabilność od dojrzałości. Projekt miał 24 wydania i wersję 1.6.0, ale nadal prowadził otwarte zgłoszenia iregularne poprawki [1][3]. „Stabilny” jest tu oceną redakcyjną, nie zmierzonym faktem.

Jakie mechanizmy odpowiadają za niezawodność SmallCode?

README wymienia budżetowanie kontekstu, tolerancyjny parser wywołań narzędzi, edycję plików patchami, planowanie przez listę TODO i automatyczną walidację kroków [1]. To rozwiązania typowe dla pracy z małymi modelami, które częściej niż duże modele psują format odpowiedzi.

Budżetowanie kontekstu pilnuje, aby prompt i historia rozmowy zmieściły się w oknie modelu. Tolerancyjny parser próbuje odzyskać wywołanie narzędzia nawet wtedy, gdy model zwróci je w lekko błędnym formacie. Edycja patchami ogranicza przepisywanie całych plików, co zmniejsza liczbę przypadkowych zmian w kodzie. Lista TODO nadaje zadaniu strukturę wieloetapową, a walidacja kroków wychwytuje nieudane operacje, zanim trafią do kolejnego etapu. Jak modele radzą sobie z długim kontekstem, pokazuje materiał /posts/abbel-vs-100k-tokenow-jak-berkeley-nauczylo-llm-pamietac-co-wazne.

Jak SmallCode wypada na tle Ollama i LM Studio?

SmallCode nie konkuruje bezpośrednio z runtime'ami modeli. Ollama i LM Studio uruchamiają modele i udostępniają lokalne API, a SmallCode wykonuje zadanie na plikach projektu. W praktyce łączy się je w jeden stos: runtime dostarcza model, agent prowadzi pracę nad kodem.

Kryterium	SmallCode	Ollama	LM Studio
Rola	agent kodujący w terminalu [1]	runtime i lokalny serwer modeli [10]	aplikacja desktopowa z GUI i serwerem API [7]
Interfejs	terminal, wywołania narzędzi [1]	terminal, lokalne API, aplikacja	GUI, API, narzędzia lms i llmster [8]
Licencja i koszt	MIT, bez opłat [1]	lokalne modele bez opłat, płatne plany cloud [11]	aplikacja bez opłat, płatne plany Bionic [12]
Modele	lokalny endpoint zgodny z OpenAI, 8B–35B [1]	biblioteka modeli i pliki GGUF [11]	katalog modeli, GGUF oraz MLX [7]
Wymagania sprzętowe	zależne od wybranego modelu	CPU, Metal, NVIDIA compute 5.0+, AMD ROCm [10]	macOS M1–M4, Windows x64 z AVX2, zalecane 16 GB RAM [9]

Aktualne wersje również się różnią tempem rozwoju. Ollama v0.40.4 została wydana 12 października 2026 r. [6]. Strona pobierania LM Studio wskazywała 15 października 2026 r. wersję v0.4.26 dla Windows, bez dokładnej daty wydania [7]. Linia 0.4.0, ogłoszona 28 stycznia 2026 r., wprowadziła serwer bez GUI llmster oraz ciągłe batchowanie [8]. Obsługa MCP pojawiła się w LM Studio w wersji 0.3.17 z 25 czerwca 2025 r. [14], a RAG dla plików PDF, DOCX i TXT jest częścią aplikacji [13].

Ceny podajemy z datą i walutą, według oficjalnych stron. Stan na październik 2026: lokalne modele w Ollama są bezpłatne i bez limitu zapytań po stronie dostawcy, a plan Pro kosztuje 20 USD miesięcznie lub 200 USD rocznie [11]. LM Studio udostępnia darmowy plan z lokalnymi modelami, a Bionic+ kosztuje 20 USD miesięcznie [12]. To ceny oficjalne, bez podatków i opłat operatora płatności.

Jakie modele lokalne mają sens w 2026 roku?

Nie ma jednego najlepszego modelu — wybór zależy od języka, zadania, pamięci i licencji. Dla pracy z kodem i agentami sensownym punktem startu są modele z rodzin Qwen3 i Gemma 4, a w języku polskim Bielik v3. Rodzina Qwen3 obejmuje warianty gęste i MoE, w tym rozmiary 4B oraz 8B, 14B i 30B [15]. Gemma 4 jest opisywana jako rodzina do rozumowania, agentów, kodu i obrazu [16]. Bielik-11B-v3.0-Instruct ma 11 mld parametrów, licencję Apache 2.0 według karty modelu i trening na 32 językach europejskich z naciskiem na polski [17].

W benchmarku LLMzSzŁ dla języka polskiego Bielik-11B-v2.1-Instruct uzyskał 57,52 punktu i był najlepszym testowanym modelem poniżej 15B parametrów [18]. Wynik dotyczy starszej wersji modelu i jednego zestawu testowego, więc nie jest uniwersalnym rankingiem. Przy wyborze warto sprawdzić kartę konkretnego wariantu, bo sama nazwa rodziny nie wystarcza do oceny prawnej. Porównanie podejść do modeli lokalnych w praktyce zawiera tekst /posts/laguna-xs-2-vs-m-1-dlaczego-polskie-firmy-testuja-lokalne-modele-jezykowe.

Ile pamięci potrzeba do lokalnego modelu?

Wymagania zależą od rozmiaru modelu i kwantyzacji, ale oficjalne minimum aplikacji daje punkt odniesienia. LM Studio podaje dla macOS układy Apple Silicon M1–M4 i system macOS 14 lub nowszy, z zalecanymi co najmniej 16 GB RAM [9]. Dla Windows wskazuje x64 z AVX2 albo ARM Snapdragon X Elite, zalecane 16 GB RAM i 4 GB dedykowanej pamięci VRAM; Intel Mac nie jest obecnie wspierany [9].

Ollama działa także na CPU, używa Metal na Apple, wymaga compute capability 5.0+ dla NVIDIA i ROCm dla AMD [10]. Docker z akceleracją GPU działa na Linuksie oraz Windows z WSL2, ale Docker Desktop na macOS nie udostępnia GPU kontenerom [10]. W praktyce karta graficzna przyspiesza generowanie odpowiedzi, nie zmienia jakości modelu — a przy braku VRAM część warstw trafia do RAM i odpowiedzi zwalniają.

Najczęstsze pytania

Czy SmallCode jest darmowy?

Tak. Kod jest dostępny na licencji MIT i można go pobrać z GitHuba lub przez npm [1]. Kosztem pozostaje sprzęt, energia i ewentualne dodatkowe aplikacje. Płatne są natomiast chmurowe plany runtime'ów — na przykład Ollama Pro za 20 USD miesięcznie [11] i LM Studio Bionic+ za 20 USD miesięcznie [12].

Czy wynik 87% to niezależny benchmark?

Nie. To deklaracja autora i repozytorium dla benchmarku z modelem o 4B aktywnych parametrów, bez publicznej nazwy zestawu testowego i pełnej metodologii [1][4]. Wyniku nie należy traktować jako uniwersalnej miary jakości ani porównywać go wprost z rankingami niezależnych testów.

Czy SmallCode działa z każdym lokalnym modelem?

README rekomenduje modele 8B–35B i lokalne endpointy zgodne z OpenAI API [1]. Modele do 4B mają problemy z wieloetapowym użyciem narzędzi, więc jakość pracy zależy od rozmiaru i zdolności modelu. Zbyt mały model będzie częściej psuł format wywołań, mimo tolerancyjnego parsera.

Czym SmallCode różni się od Ollama?

Ollama to runtime i lokalny serwer modeli, a SmallCode to agent kodujący, który z takiego serwera korzysta [1][6]. Można ich używać razem: Ollama udostępnia model pod lokalnym adresem, a SmallCode czyta pliki projektu i wykonuje zadania. Ollama nie jest narzędziem do edycji kodu, a SmallCode nie uruchamia modeli sam z siebie.

Źródła

O autorze

Andrzej Niemiec

Fanatyk nowych technologii i specjalista w zakresie sztucznej inteligencji.

→ LinkedIn → www