Zasoby

Wszystko wokół produktu, a nie w nim: jak uzyskać pomoc, jak współtworzyć i jak rozszerzać platformę.

Pomóż AgenticOS

Projekt jest młody, a najszybszym sposobem, żeby mu pomóc, jest używać go i mówić, co się zepsuło.

• Zgłoś błąd

  Co się psuje, jaka sekwencja to wywołuje i po czym poznasz, że zostało naprawione. Tego trzeciego brakuje w większości zgłoszeń.

• Zaproponuj coś

  Najpierw sprawdź mapę zgłoszeń — mówi, co jest już zaplanowane, a co nie ma jeszcze zakresu.

• Daj gwiazdkę repozytorium

  To najtańszy sygnał, że warto to ciągnąć dalej.

Rozwój - współtworzenie

Przeczytaj stronę pasującą do tego, czego dotykasz. To są własne notatki inżynierskie repozytorium, opublikowane, a nie przepisane, więc czytasz to samo, co czytają kontrybutorzy.

Pracujesz nad	Przeczytaj
Czymkolwiek, na początek	Architektura · Kod konsoli — trasy → serwisy → repozytoria oraz transakcja żądania
Kształtem, który już widziałeś	Wzorce
Funkcją od początku do końca	Dodawanie funkcji
Testem albo czerwoną bramką pokrycia	Testowanie
Pull requestem	Przegląd kodu i Gałęzie

Trzy rzeczy, które cię ugryzą

Repozytorium zapisuje przez db.flush(), nigdy przez db.commit(). Praca w tle, która czyta wiersz zapisany właśnie przez żądanie, jest przekazywana przez spawn_after_commit, nigdy przez spawn. A warstwa platformowa jest trzymana na 100% pokrycia, egzekwowanym w CI. Wszystkie trzy są w Architekturze i Testowaniu i wszystkie trzy zostały tu przynajmniej raz zrobione źle.

Rozszerzanie platformy

Dokładanie do tego, co potrafi samo AgenticOS, w Pythonie. To są przepisy dla kontrybutorów — potrzebujesz sklonowanego repozytorium.

• Dodaj capability — nowe narzędzie, które model może wywołać
• Dodaj serwer do katalogu MCP
• Dodaj endpoint API
• Dodaj zadanie w tle
• Dodaj konektor synchronizacji

Zanim napiszesz capability

Zastanów się, czy to naprawdę nie jest połączenie MCP. Capability, która byłaby klientem API jednego produktu SaaS, to serwer, który ktoś już napisał, a wzięcie go do tego repozytorium oznacza utrzymywanie go wobec API tamtego produktu na zawsze.

Zbudowane na

AgenticOS jest wygenerowany z Full-Stack AI Agent Template i stoi na:

• Pydantic AI — runtime agenta
• FastAPI i Pydantic — backend
• pgvector — wyszukiwanie
• Prefect — praca w tle
• Next.js — konsola
• Model Context Protocol — każda integracja

Licencja

Apache 2.0. Zobacz LICENSE.