Übersetzung in Arbeit

Diese Seite wird automatisch aus dem englischen Original gespiegelt, bis eine deutsche Übersetzung vorliegt. Der Inhalt ist auf Englisch — die Navigation und Oberfläche sind bereits übersetzt.

Quick Start

This page assumes you've cloned the Atlas repo and have Python 3.11+ and Node 18+ installed.

1. Configure environment variables

Copy the example file and fill in the keys you have:

cp .env.example .env

The minimum set to boot the app:

Variable	Where to get it	Required for
DATABASE_URL	Local Postgres or hosted	Backend startup
SECRET_KEY	Generate a random 32+ char string	JWT auth
EODHD_API_KEY	eodhd.com	Quotes, fundamentals, EOD
CESIUM_ION_TOKEN	cesium.com/ion	3D globe (backend)
VITE_CESIUM_ION_TOKEN	same value, for the frontend	3D globe (frontend bundle)
REDIS_URL	Local Redis or hosted	Cache layer

Optional providers (vessels, aircraft) work without keys but with reduced rate limits.

Email + OAuth (enable on demand):

Variable	Purpose
PUBLIC_APP_URL	Base URL used in verification + reset links
EMAIL_ENABLED	Master switch for outbound mail
EMAIL_SMTP_HOST/PORT/USERNAME/PASSWORD	SMTP relay credentials
EMAIL_FROM / EMAIL_FROM_NAME	From: header
AUTH_EMAIL_VERIFICATION_ENABLED	Send verification mails on signup
AUTH_REQUIRE_EMAIL_VERIFICATION	Block gated actions until verified
EMAIL_TOKEN_TTL_MINUTES	Verification link TTL (default 60)
PASSWORD_RESET_TOKEN_TTL_MINUTES	Reset link TTL (default 30)
GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET	Google sign-in
OAUTH_GITHUB_CLIENT_ID / OAUTH_GITHUB_CLIENT_SECRET	GitHub sign-in

Markets and aircraft tuning (rarely changed):

Variable	Purpose
MARKET_SNAPSHOT_EOD_FALLBACK_LIMIT	Cap on per-request EOD fallback for non-realtime exchanges (default 120)
AIRCRAFT_FIXTURE_FALLBACK	False in prod — filters out MOCK* callsigns
SEZGIN_API_URL	Sezgin Quant Core endpoint for AI Brain (default http://localhost:8088)

Secrets handling

Never commit .env. Never paste real keys into chat or commit messages. Use placeholders like your_api_key_here in examples. See Data providers and OSINT operational security for details.

2. Start the backend

cd backend
poetry install
poetry run uvicorn main:app --reload --port 8000

Verify: curl http://localhost:8000/health should return {"status":"ok"}.

3. Start the frontend

In a second terminal:

cd frontend
npm install
npm run dev

Open http://localhost:5173. You should see the Atlas globe and an empty watchlist.

4. Add your first ticker

1. Open the Markets panel.
2. Type a symbol (try AAPL).
3. Click Add to watchlist.

You now have a live quote streaming and a chart populated with EOD history.

Next steps

• Core Concepts — understand panels, layers, and the timeline.
• For traders — recommended layout and shortcuts.
• For OSINT analysts — turning on AIS and ADS-B layers.