Documentation

Configuration reference

CScope reads its settings from environment variables and the .env file in the project root.

Core settings

VariableDefaultPurpose
CCIIPSCOPE_DATA_DIR./dataDatabase, uploads, parsed assets, and logs
CCIIPSCOPE_RETENTION_DAYS30Inactive-project retention period
CCIIPSCOPE_MAX_UPLOAD_BYTES52428800Maximum upload size
CCIIPSCOPE_CLEANUP_INTERVAL21600Cleanup interval in seconds
CCIIPSCOPE_ENABLE_LOCAL_COMPILEfalseAllow host-side LaTeX compilation

Model configuration

The built-in MiniMax profile uses MINIMAX_API_KEY and CCIIPSCOPE_MINIMAX_BASE_URL. Additional configurations use a normalized nickname:

CCIIPSCOPE_MODEL_REVIEW_DISPLAY_NAME=Review Model
CCIIPSCOPE_MODEL_REVIEW_PROVIDER=openai
CCIIPSCOPE_MODEL_REVIEW_MODEL=model-name
CCIIPSCOPE_MODEL_REVIEW_BASE_URL=https://api.example.com/v1
CCIIPSCOPE_MODEL_REVIEW_API_KEY=secret

PROVIDER identifies the API protocol, not the model vendor. Paper analysis uses long contexts and expects responses in specific JSON formats, so choose a model with enough context and reliable structured output.

MinerU parser configuration

PDF files are parsed by an on-demand MinerU Docker container. When parsing begins, CScope checks for an available GPU and uses it when possible. The container stops and releases its resources after parsing. Environment variables can be used to configure the image, timeout, and GPU thresholds.

CScope uses SearXNG for general search and also queries academic sources such as arXiv, OpenReview, DBLP, and Crossref. Service endpoints and search behavior can be adjusted in the configuration file.