82 lines
1.8 KiB
ReStructuredText
82 lines
1.8 KiB
ReStructuredText
Configuration
|
|
=============
|
|
|
|
GOD separates machine settings from experiment selection.
|
|
|
|
``.env``
|
|
--------
|
|
|
|
``.env`` stores local model, port, and startup settings. It is created from ``.env.example`` and ignored by Git.
|
|
|
|
Required model settings:
|
|
|
|
.. list-table::
|
|
:header-rows: 1
|
|
|
|
* - Variable
|
|
- Purpose
|
|
- Default
|
|
* - ``GOD_LLM_API_KEY``
|
|
- OpenAI-compatible API key
|
|
- empty
|
|
* - ``GOD_LLM_API_BASE``
|
|
- OpenAI-compatible API base URL
|
|
- ``https://api.openai.com/v1``
|
|
* - ``GOD_LLM_MODEL``
|
|
- Chat model used by GOD and the runtime
|
|
- empty; required before model-backed runs
|
|
* - ``GOD_EMBEDDING_MODEL``
|
|
- Embedding model
|
|
- ``text-embedding-3-large``
|
|
|
|
``.god/current_experiment.json``
|
|
--------------------------------
|
|
|
|
The setup wizard writes the active experiment here. ``start``, ``open``, and ``new-run`` read this file so ``.env`` does not accidentally decide the current map or scenario.
|
|
|
|
Explicit overrides
|
|
------------------
|
|
|
|
For one-off runs, these environment variables override current-experiment state:
|
|
|
|
.. code-block:: bash
|
|
|
|
GOD_EXPERIMENT=pku_trump_visit GOD_EXPERIMENT_RUN=1 ./scripts/god.sh new-run
|
|
|
|
Common ports
|
|
------------
|
|
|
|
.. list-table::
|
|
:header-rows: 1
|
|
|
|
* - Variable
|
|
- Default
|
|
- Service
|
|
* - ``GOD_BACKEND_PORT``
|
|
- ``8001``
|
|
- FastAPI backend
|
|
* - ``GOD_FRONTEND_PORT``
|
|
- ``5174``
|
|
- GOD control room
|
|
* - ``RUNTIME_AGENT_PORT``
|
|
- ``19092``
|
|
- JiuwenClaw agent WebSocket
|
|
* - ``RUNTIME_WEB_PORT``
|
|
- ``20000``
|
|
- JiuwenClaw web service
|
|
* - ``RUNTIME_GATEWAY_PORT``
|
|
- ``20001``
|
|
- JiuwenClaw gateway
|
|
* - ``RUNTIME_UI_PORT``
|
|
- ``6173``
|
|
- Runtime UI
|
|
|
|
Browser opening
|
|
---------------
|
|
|
|
Disable automatic browser opening:
|
|
|
|
.. code-block:: bash
|
|
|
|
GOD_OPEN_BROWSER=0 ./scripts/god.sh start
|