@@ -13,14 +13,14 @@ not read API keys from the environment.
1313
1414## Layout
1515
16- | Path | Role |
17- | -------------------- | ------------------------------------------------------ |
18- | ` argv.py ` | Pure settings + argv builders (unit-tested, no Harbor) |
19- | ` session.py ` | Parse harvested ` ~/.corbits ` usage (unit-tested) |
20- | ` agent.py ` | ` Corbits ` installed agent (requires Harbor at import) |
21- | ` tasks/trivial/ ` | Minimal smoke task (` hello.txt ` ) |
22- | ` tests/test_argv.py ` | Argv/settings unit tests |
23- | ` tests/test_session.py ` | Session usage harvest unit tests |
16+ | Path | Role |
17+ | ----------------------- | ------------------------------------------------------ |
18+ | ` argv.py ` | Pure settings + argv builders (unit-tested, no Harbor) |
19+ | ` session.py ` | Parse harvested ` ~/.corbits ` usage (unit-tested) |
20+ | ` agent.py ` | ` Corbits ` installed agent (requires Harbor at import) |
21+ | ` tasks/trivial/ ` | Minimal smoke task (` hello.txt ` ) |
22+ | ` tests/test_argv.py ` | Argv/settings unit tests |
23+ | ` tests/test_session.py ` | Session usage harvest unit tests |
2424
2525## Prerequisites
2626
@@ -50,24 +50,24 @@ temp settings file only:
5050
5151` providers.<provider>.baseURL ` is always written. Resolve it via one of:
5252
53- | Source | Notes |
54- | -------------------------- | --------------------------------------------------------------------- |
55- | ` base_url= ` agent kwarg | Preferred for one-off runs |
56- | Harbor configured URL | ` model_connection.configured_base_url ` (` CORBITS_BASE_URL ` / ` XAI_BASE_URL ` / …) |
57- | Harbor inferred catalog | ` model_connection.base_url ` — e.g. xAI → ` https://api.x.ai/v1 ` when an API key is present |
58- | ` CORBITS_BASE_URL ` | Adapter env (also feeds Harbor configured URL) |
53+ | Source | Notes |
54+ | ----------------------- | -------------------- --------------------------------------------------------------------- |
55+ | ` base_url= ` agent kwarg | Preferred for one-off runs |
56+ | Harbor configured URL | ` model_connection.configured_base_url ` (` CORBITS_BASE_URL ` / ` XAI_BASE_URL ` / …) |
57+ | Harbor inferred catalog | ` model_connection.base_url ` — e.g. xAI → ` https://api.x.ai/v1 ` when an API key is present |
58+ | ` CORBITS_BASE_URL ` | Adapter env (also feeds Harbor configured URL) |
5959
6060Stock ` harbor run -m xai/grok-4.5 ` with ` XAI_API_KEY ` therefore does ** not** need an explicit ` base_url ` . The adapter still fail-closes if nothing resolves.
6161
6262Do ** not** point Harbor cells at the grok-cli OAuth proxy (` https://cli-chat-proxy.grok.com/v1 ` ). That URL only accepts OAuth tokens from ` ~/.corbits/xai-auth.json ` , which Harbor containers do not have. Profile-qualified product cells (` xai/<profile> ` , ` codex/<profile> ` ) are OAuth; use an API-key provider name (` xai ` , ` openai ` , …) inside Harbor.
6363
6464Example values:
6565
66- | Cell | Example ` base_url ` |
67- | ----------------------------- | ------------------------------------------------------------------------------------ |
68- | xAI API key | ` https://api.x.ai/v1 ` (Harbor infers this) |
69- | Product OAuth / grok-cli path | Not usable in Harbor containers |
70- | OpenAI-compatible | e.g. ` https://api.openai.com/v1 ` or your cell's gateway |
66+ | Cell | Example ` base_url ` |
67+ | ----------------------------- | ------------------------------------------------------- |
68+ | xAI API key | ` https://api.x.ai/v1 ` (Harbor infers this) |
69+ | Product OAuth / grok-cli path | Not usable in Harbor containers |
70+ | OpenAI-compatible | e.g. ` https://api.openai.com/v1 ` or your cell's gateway |
7171
7272Optional: ` shell_timeout_ms= ` → ` shell.timeoutMs ` in settings.
7373
0 commit comments