agentica-server
Agentica server + Claude proxy setup - architecture, startup sequence, debugging
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Agentica server + Claude proxy setup - architecture, startup sequence, debugging
How to use
Przygotuj trzy oddzielne terminale — każdy będzie uruchamiać inny komponent stosu. Upewnij się, że masz zainstalowane uv oraz dostęp do Claude CLI.
W pierwszym terminalu uruchom Claude proxy na porcie 8080: uv run python scripts/agentica/claude_proxy.py --port 8080. Czekaj, aż proxy będzie gotowe do przyjmowania żądań.
W drugim terminalu przejdź do katalogu serwera Agentica i ustaw zmienną środowiskową INFERENCE_ENDPOINT_URL wskazującą na proxy, następnie uruchom serwer na porcie 2345: cd workspace/agentica-research/agentica-server, potem INFERENCE_ENDPOINT_URL=http://localhost:8080/v1/chat/completions uv run agentica-server --port 2345.
W trzecim terminalu ustaw zmienną S_M_BASE_URL na adres serwera i uruchom swój skrypt agenta: S_M_BASE_URL=http://localhost:2345 uv run python scripts/agentica/your_script.py. Zastąp your_script.py nazwą Twojego pliku.
Aby sprawdzić, czy wszystko działa, użyj curl do testowania health checków — dla proxy: curl http://localhost:8080/health, dla serwera: curl http://localhost:2345/health. Jeśli obie odpowiedzi są pozytywne, agent może się połączyć.
Jeśli napotkasz problemy z połączeniem, pamiętaj, że SDK łączy się z serwerem (port 2345), a serwer łączy się z proxy (port 8080) — to dwa różne endpointy. Sprawdź logi w każdym terminalu, aby zidentyfikować, gdzie połączenie się przerywa.