FAQ

Frequently Asked Questions

Where should I start?

Read the Overview, then follow Local Development to run OpenBcon locally.

Does OpenBcon require an AI API key?

Not for a local demonstration: set OPENBCON_USE_MOCK_LLM=true. For real report generation, configure a server-side model provider key and an allowlisted provider host. Never place the key in browser configuration.

Where is the generated report?

Open /strategic-reports?app_id=..., or reopen the application from My Applications. Each application has one persisted Strategic Report; generation updates that report rather than creating a second report.

How do I add funding data?

Use Admin > Data Sources to create, enable, and manually sync JSON, Google Sheets, or Airtable sources. Airtable must use a server-side proxy to keep its access token out of the browser. See Configuration.

How do Test and Live Mode work?

The environment variable OPENBCON_ENVIRONMENT_MODE selects the server-side database boundary. Change it and restart Node and Python services; the browser cannot select a different environment with a request header.

How do I deploy it?

Use the bootstrap command in Deployment. It creates the production environment configuration, validates the proxy, starts services, and waits for health checks.

What should I do if a production service is unhealthy?

Inspect its logs using the production Compose file and environment file, then verify /api/health through the public domain. Preserve database volumes while diagnosing; do not use down --volumes unless deliberately deleting data.

How do I report a security issue?

Email security@bconomics.ai; do not publish exploit details in a public issue. See Security.