Reference
Configuration
ICML_PAPERS_ environment variables and defaults.
Copy .env.example to .env for local use. Explicit environment variables override .env; all names use the ICML_PAPERS_ prefix.
Secret
Set the key directly or through a file:
ICML_PAPERS_DASHSCOPE_API_KEY=
ICML_PAPERS_DASHSCOPE_API_KEY_FILE=/run/secrets/dashscope_api_keyThe file takes precedence. Public deployments should use a read-only secret file. Invalid values or inconsistent combinations stop the process before startup.
JSON environment values
Use JSON arrays for list settings:
ICML_PAPERS_ALLOWED_HOSTS=["papers.example.com:443"]
ICML_PAPERS_TRUSTED_PROXY_NETWORKS=["172.20.0.0/16"]Use the exact public Host, Origin, and proxy network in production.
Fields
This table is generated from the runtime settings schema.
| Environment variable | Type | Default | Constraints |
|---|---|---|---|
ICML_PAPERS_DATA_DIR | string | data | — |
ICML_PAPERS_INDEX_ROOT | string | .data/index | — |
ICML_PAPERS_STATE_DB_PATH | string | .data/state/runtime.sqlite3 | — |
ICML_PAPERS_SQLITE_BUSY_TIMEOUT_MS | integer | 5000 | ≥ 100, ≤ 60000 |
ICML_PAPERS_DASHSCOPE_API_KEY | string | null | unset | — |
ICML_PAPERS_DASHSCOPE_API_KEY_FILE | string | null | unset | — |
ICML_PAPERS_DASHSCOPE_HTTP_BASE_URL | string | https://dashscope.aliyuncs.com/api/v1 | — |
ICML_PAPERS_EMBEDDING_MODEL | string | qwen3.7-text-embedding | — |
ICML_PAPERS_EMBEDDING_DIM | integer | 1024 | ≥ 1 |
ICML_PAPERS_EMBEDDING_BATCH_SIZE | integer | 20 | ≥ 1, ≤ 20 |
ICML_PAPERS_EMBEDDING_MAX_ATTEMPTS | integer | 3 | ≥ 1, ≤ 5 |
ICML_PAPERS_EMBEDDING_DEADLINE_SECONDS | number | 12.0 | > 0, ≤ 60 |
ICML_PAPERS_MILVUS_URI | string | http://127.0.0.1:19530 | — |
ICML_PAPERS_MILVUS_COLLECTION_PREFIX | string | icml2026_mcp | — |
ICML_PAPERS_MILVUS_TIMEOUT_SECONDS | number | 10.0 | > 0, ≤ 120 |
ICML_PAPERS_DEFAULT_TOP_K | integer | 10 | ≥ 1 |
ICML_PAPERS_MAX_TOP_K | integer | 50 | ≥ 1 |
ICML_PAPERS_DEPTH_MULTIPLIER | integer | 4 | ≥ 1 |
ICML_PAPERS_MAX_SEARCH_DEPTH | integer | 200 | ≥ 1 |
ICML_PAPERS_MAX_QUERY_CHARS | integer | 4000 | ≥ 1 |
ICML_PAPERS_MAX_GET_PAPER_IDS | integer | 50 | ≥ 1 |
ICML_PAPERS_SESSION_IDLE_TTL_SECONDS | integer | 86400 | ≥ 60 |
ICML_PAPERS_MAX_SESSIONS | integer | 4096 | ≥ 1 |
ICML_PAPERS_EXHAUSTED_AFTER_EMPTY_ROUNDS | integer | 3 | ≥ 1 |
ICML_PAPERS_MAX_SESSION_ROUNDS | integer | 200 | ≥ 1 |
ICML_PAPERS_MAX_SESSION_SEEN | integer | 6341 | ≥ 1 |
ICML_PAPERS_MAX_SESSION_AUDIT_RECORDS | integer | 200 | ≥ 0 |
ICML_PAPERS_SESSION_SUMMARY_PAPER_LIMIT | integer | 500 | ≥ 0 |
ICML_PAPERS_SESSION_LABEL_MAX_CHARS | integer | 120 | ≥ 1 |
ICML_PAPERS_PROVIDER_CONCURRENCY | integer | 64 | ≥ 1 |
ICML_PAPERS_MILVUS_CONCURRENCY | integer | 32 | ≥ 1 |
ICML_PAPERS_SEARCH_QUEUE_SIZE | integer | 512 | ≥ 1 |
ICML_PAPERS_QUEUE_TIMEOUT_SECONDS | number | 10.0 | > 0 |
ICML_PAPERS_IP_RATE_PER_MINUTE | integer | 600 | ≥ 1 |
ICML_PAPERS_IP_RATE_BURST | integer | 100 | ≥ 1 |
ICML_PAPERS_IP_SEARCHES_PER_DAY | integer | 50000 | ≥ 1 |
ICML_PAPERS_IP_SESSION_OPEN_RATE_PER_MINUTE | integer | 60 | ≥ 1 |
ICML_PAPERS_IP_SESSION_OPEN_BURST | integer | 20 | ≥ 1 |
ICML_PAPERS_IP_SESSION_OPENS_PER_DAY | integer | 5000 | ≥ 1 |
ICML_PAPERS_GLOBAL_RATE_PER_MINUTE | integer | 6000 | ≥ 1 |
ICML_PAPERS_PROVIDER_REQUESTS_PER_MINUTE | integer | 24000 | ≥ 1 |
ICML_PAPERS_PROVIDER_TOKENS_PER_MINUTE | integer | 1000000 | ≥ 1 |
ICML_PAPERS_EMBEDDING_CACHE_MAX_ENTRIES | integer | 100000 | ≥ 0 |
ICML_PAPERS_EMBEDDING_CACHE_TTL_SECONDS | integer | 86400 | ≥ 0 |
ICML_PAPERS_ABSTRACT_PREVIEW_CHARS | integer | 360 | ≥ 0 |
ICML_PAPERS_MAX_AUTHORS_SHOWN | integer | 4 | ≥ 0 |
ICML_PAPERS_SERVER_HOST | string | 127.0.0.1 | — |
ICML_PAPERS_SERVER_PORT | integer | 20441 | ≥ 1, ≤ 65535 |
ICML_PAPERS_ALLOWED_HOSTS | string[] | ["127.0.0.1:*", "localhost:*", "[::1]:*", "icml-mcp:*"] | — |
ICML_PAPERS_ALLOWED_ORIGINS | string[] | ["http://127.0.0.1:*", "http://localhost:*"] | — |
ICML_PAPERS_TRUSTED_PROXY_ENABLED | boolean | false | — |
ICML_PAPERS_TRUSTED_PROXY_HEADER | string | X-ICML-Client-IP | — |
ICML_PAPERS_TRUSTED_PROXY_NETWORKS | string[] | [] | — |