Configuration

Parascope is configured via environment variables defined in a .env file in the project root. You can start by copying the provided example:

cp .env.example .env

Below is a reference of all available configuration options.

General Configuration

Variable	Default	Description
`SERVER_HOSTNAME`	`localhost`	The hostname where the server is running.
`PROJECT_NAME`	`Parascope`	The name of the project, used in titles and metadata.
`DEBUG`	`true`	Enable debug mode for more verbose logging.

Variable	Default	Description
`FRONTEND_PORT`	`3000`	The port where the React frontend application will be served.
`VITE_API_BASE_URL`	Calculated	(Optional) URL of the backend API. Defaults to `http://${SERVER_HOSTNAME}:${BACKEND_PORT}`.

Variable	Default	Description
`BACKEND_PORT`	`8000`	The port where the FastAPI backend will be served.
`BACKEND_CORS_ORIGINS`	Calculated	(Optional) Comma-separated list of allowed CORS origins. Defaults to frontend URLs.
`DATABASE_URL`	Example	Connection string for the PostgreSQL database.
`UPLOAD_DIR`	`uploads`	Directory to store uploaded files.
`LOCK_TIMEOUT_SECONDS`	`604800`	Duration (in seconds) before a sheet lock expires (Default: 7 days).
`WORKER_COUNT`	`5`	Number of worker processes in the execution pool.

Variable	Default	Description
`EXTRA_ALLOWED_MODULES`	`scipy`	Comma-separated list of additional Python modules allowed in the sandbox.
`EXTRA_PRELOAD_MODULES`	(Empty)	Comma-separated list of modules to preload in worker processes for faster startup.

Variable	Default	Description
`USERNAME_REGEX`	`^[a-zA-Z0-9_ ]+$`	Regex pattern to validate usernames.
`USERNAME_DESCRIPTION`	Description	Human-readable description of valid username formats.

Configure generative AI providers for the "Generate Function" feature.

Variable	Default	Description
`DEFAULT_AI_PROVIDER`	`gemini`	The default provider to use (`gemini`, `openai`, `bedrock`).