{"id":51090962,"url":"https://github.com/depthsight-pro/depthsight","last_synced_at":"2026-07-12T06:00:45.546Z","repository":{"id":363308664,"uuid":"1262628565","full_name":"DepthSight-Pro/DepthSight","owner":"DepthSight-Pro","description":"Self-hosted visual crypto trading platform built with FastAPI, React, and Redis. Features genetic backtesting and AI strategy generation.","archived":false,"fork":false,"pushed_at":"2026-07-04T15:56:01.000Z","size":8759,"stargazers_count":10,"open_issues_count":0,"forks_count":4,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-04T17:13:14.643Z","etag":null,"topics":["ai-agents","algotrading","crypto-trading-bot","fastapi","open-source","python","react","self-hosted","trading-platform"],"latest_commit_sha":null,"homepage":"https://depthsight.pro/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DepthSight-Pro.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":"CLA.md"}},"created_at":"2026-06-08T07:03:16.000Z","updated_at":"2026-07-04T15:56:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/DepthSight-Pro/DepthSight","commit_stats":null,"previous_names":["depthsight-pro/depthsight"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/DepthSight-Pro/DepthSight","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DepthSight-Pro%2FDepthSight","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DepthSight-Pro%2FDepthSight/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DepthSight-Pro%2FDepthSight/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DepthSight-Pro%2FDepthSight/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DepthSight-Pro","download_url":"https://codeload.github.com/DepthSight-Pro/DepthSight/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DepthSight-Pro%2FDepthSight/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35383520,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-12T02:00:06.386Z","response_time":87,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","algotrading","crypto-trading-bot","fastapi","open-source","python","react","self-hosted","trading-platform"],"created_at":"2026-06-24T02:00:21.426Z","updated_at":"2026-07-12T06:00:45.514Z","avatar_url":"https://github.com/DepthSight-Pro.png","language":"Python","funding_links":[],"categories":["🔥 AI Powered Systematic Trading Systems"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/logo.svg\" alt=\"DepthSight Logo\" width=\"320\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eDepthSight\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-AGPL--3.0-blue.svg\" alt=\"License: AGPL-3.0\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.python.org/\"\u003e\u003cimg src=\"https://img.shields.io/badge/python-3.11+-3776AB.svg?logo=python\u0026logoColor=white\" alt=\"Python 3.11+\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.docker.com/\"\u003e\u003cimg src=\"https://img.shields.io/badge/docker-ready-2496ED.svg?logo=docker\u0026logoColor=white\" alt=\"Docker Ready\"\u003e\u003c/a\u003e\n  \u003ca href=\"#-one-click-deploy\"\u003e\u003cimg src=\"https://img.shields.io/badge/deploy-one--click-00C853.svg?logo=gnubash\u0026logoColor=white\" alt=\"One-Click Deploy\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://depthsight.pro\"\u003e\u003cimg src=\"https://img.shields.io/badge/website-depthsight.pro-lightgrey.svg\" alt=\"Website\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://depthsight.pro/docs/overview\"\u003e\u003cimg src=\"https://img.shields.io/badge/docs-depthsight.pro-00b0aa?style=flat\u0026logo=googledocs\u0026logoColor=white\" alt=\"Documentation\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/DepthSight-Pro/DepthSight/actions\"\u003e\u003cimg src=\"https://img.shields.io/badge/tests-1100%2B%20passed-brightgreen\" alt=\"Tests\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eEnterprise-Grade, Multi-Tenant SaaS-in-a-Box for Algorithmic Trading.\u003c/strong\u003e\n\u003c/p\u003e\n\nBuilt to democratize the fin-tech industry, it provides a complete infrastructure to launch your own crypto trading platform (like 3Commas or Veles) out of the box. It features a drag-and-drop strategy builder, an AI-powered assistant, a federated community hub for sharing strategies, isolated multi-user environments, and native Bitcart crypto billing.\n\n\u003cp align=\"center\"\u003e\n  \u003cem\u003eYou bring the traffic. DepthSight handles the execution.\u003c/em\u003e\n\u003c/p\u003e\n\n\u003e ⭐ **If you find this project useful, please consider giving it a star! It helps the community grow and reach more developers.**\n\n\u003e **⚠️ DISCLAIMER: HIGH FINANCIAL RISK**\n\u003e\n\u003e **DepthSight is currently in Open Beta.** The software is provided \"as is\", without warranty of any kind. \n\u003e Algorithmic and live trading involves real financial risk and can result in the total loss of your funds. The authors, contributors, and licensors of this project are **not responsible for any financial losses**, damages, or issues arising from the use of this software. \n\u003e \n\u003e Always use testnet or paper trading first. Do not connect real funds unless you fully understand the code and have verified the entire workflow in a controlled environment. You are solely responsible for your trading decisions and capital.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/strategy-editor.gif\" alt=\"Visual Strategy Builder Demo\" width=\"800\"\u003e\n  \u003cbr\u003e\n  \u003cem\u003eDescribe your idea in plain language -\u003e AI builds a complete multi-stage strategy.\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cdetails\u003e\n    \u003csummary\u003e\u003cb\u003e🎬 Video Demonstration (Click to expand)\u003c/b\u003e\u003c/summary\u003e\n    \u003cbr\u003e\n    \u003ca href=\"https://youtu.be/-Fxp-3VSODM\" target=\"_blank\"\u003e\n      \u003cimg src=\"https://img.youtube.com/vi/-Fxp-3VSODM/maxresdefault.jpg\" alt=\"DepthSight Video Demo\" width=\"800\"\u003e\n    \u003c/a\u003e\n  \u003c/details\u003e\n\u003c/div\u003e\n\n## Core Features\n\n- **Visual Strategy Builder:** A drag-and-drop interface with 40+ logic blocks. Build complex strategies with cross-referencing nodes (e.g., dynamically place a stop loss behind order book density, a breakout candle, or a key level).\n- **AI-Powered Assistant:** Generate complete strategy logic from text prompts or **even screenshots of chart setups**. The AI also analyzes your live trades and backtest results to provide actionable trading recommendations.\n- **Weighted Foundations System:** Assign weights to different market conditions. A trade executes only if a target confidence threshold is met, allowing for flexible, probability-based entries rather than strict \"all-or-nothing\" boolean logic.\n- **Dynamic Risk Management:** An intelligent RM engine that automatically adapts position sizing and risk parameters based on the historical and real-time performance of each specific trading pair.\n- **Advanced Market Data:** Native support for order book snapshots, trade streams, open interest, BTC correlation, and multi-timeframe analysis.\n- **Rich Visualization:** Complete transparency into bot logic. Every trade includes a detailed decision tree explaining *why* it was taken, visualized directly on trading charts.\n- **Dual Backtesting Engines:** Lightning-fast vector backtester for rapid prototyping and genetic optimization, plus a detailed candle/tick-level engine for precise execution simulation.\n- **Discovery Hub \u0026 Community Network:** A centralized sharing repository where users import verified strategy templates, inspect community trading ideas (complete with win rate, drawdown, mini-charts, and comments), and join discussions. Includes a live global node network topology map (with complete IP privacy) showing real-time heartbeat synchronization log feeds, and a dialogue-enabled support ticket system supporting chat messages and image uploads.\n- **Enterprise-Grade Infrastructure:** FastAPI backend, real-time WebSocket events, background Celery workers, and multi-exchange execution.\n## Enterprise-Grade Scalability\n\nDepthSight is built for heavy-duty algorithmic trading, requiring a minimum of 6 modern CPU cores and 16GB RAM for a stable solo instance. Its stateless architecture naturally supports advanced horizontal scaling patterns for Cloud SaaS deployments handling thousands of users:\n\n1. **Distributed Market Data (Sharding):** The centralized market data service reduces the number of exchange WebSocket connections, allowing for shard-based division of trading pairs.\n2. **Redis Splitting:** Separate instances for system state (JWT, rate limits, Celery) and high-throughput HFT market data via Pub/Sub.\n3. **Horizontal Worker Scaling:** Trading bot processes run in a sharded, stateless pool, evenly dividing computation and risk management processing across CPU cores or physical nodes.\n4. **PgBouncer-Ready:** Designed to pool PostgreSQL connections, seamlessly handling thousands of concurrent connections from stateless FastAPI or bot worker nodes.\n\n- **Supported Exchanges:** Native integration with **Binance** and **Bybit** (Fully tested and stable). Support for **Bitget**, **OKX**, **Gate.io**, and **BingX** is currently in development and will be enabled in future updates. \n  *Note: We recommend using Binance or Bybit for live trading at this stage.*\n- **Multi-Tenant SaaS Ready:** Built-in JWT authentication, Redis-based quota management, and fully isolated execution environments designed for multi-user, commercial deployments.\n- **Crypto Billing \u0026 Payments:** Native integration with Bitcart for processing cryptocurrency subscriptions and payments.\n- **Modern Clients:** Full-featured React web dashboard and a mobile-optimized PWA.\n\n## ⚔️ DepthSight vs. Alternatives\n\nHow DepthSight compares to leading open-source frameworks and commercial trading platforms:\n\n| Criterion | DepthSight | Freqtrade (34k★) | Vibe-Trading (12.7k★) | AI Hedge Fund (49k★) | 3Commas | Veles |\n| :--- | :--- | :--- | :--- | :--- | :--- | :--- |\n| **Type** | Production SaaS-in-a-box | Trading framework | AI research workspace | Educational script | Commercial SaaS | Commercial DCA/Grid |\n| **License \u0026 Code** | ✅ Open-source (AGPL) | ✅ Open-source (GPL) | ✅ Open-source (MIT) | ✅ Open-source (MIT) | ❌ Proprietary | ❌ Proprietary |\n| **Hosting** | ✅ Self-hosted | ✅ Self-hosted | ✅ Self-hosted | ✅ Self-hosted | ❌ Cloud-only | ❌ Cloud-only |\n| **Target Market** | Crypto (Binance, Bybit via CCXT) | Crypto (CCXT) | Stocks (US markets) | Stocks (US markets) | Crypto (Global) | Crypto (Global) |\n| **Visual UI** | ✅ Drag-and-drop Node Graph | ⚠️ Basic WebUI | ❌ CLI only | ❌ CLI only | ⚠️ DCA Bot Cards | ⚠️ Pre-built Templates |\n| **AI Assistant** | ✅ Prompts + Chart Screenshots | ⚠️ FreqAI (ML only) | ✅ NL → Strategy | ✅ Multi-agent Analysis | ⚠️ DCA chatbot | ❌ None |\n| **Backtesting** | ✅ Dual (vector + candle/tick) | ✅ Powerful + Hyperopt | ✅ Included | ⚠️ Basic | ⚠️ Limited AI chat | ✅ Basic backtests |\n| **Multi-Tenant SaaS** | ✅ JWT + Redis Quotas | ❌ Single-user | ❌ Single-user | ❌ Single-user | ✅ Yes (Proprietary) | ✅ Yes (Proprietary) |\n| **Risk Management** | ✅ Dynamic (adapts per pair) | ⚠️ Standard SL/TP | ❌ None | ⚠️ Simple agent | ❌ Fixed SL/TP | ⚠️ Trailing / Breakeven |\n| **Weighted Entries** | ✅ Weighted conditions system | ❌ None | ❌ None | ❌ None | ❌ None | ❌ None |\n| **Mobile Client** | ✅ PWA | ⚠️ Telegram bot | ❌ None | ❌ None | ✅ iOS / Android | ✅ iOS App |\n\n## 🚀 One-Click Deploy\n\nDepthSight requires a minimum of 6 modern CPU cores and 16GB RAM. If you need a server, you can support this open-source project by using our referral links below:\n\n- **[DigitalOcean](https://www.digitalocean.com/?refcode=681ba89f8858\u0026utm_campaign=Referral_Invite\u0026utm_medium=Referral_Program\u0026utm_source=badge)** — Get **$200 in free credit** for 60 days. Excellent for stable API performance.\n- **[Vultr](https://www.vultr.com/?ref=9905236-9J)** — Get **$300 in free credit** to test the platform. Great high-frequency compute nodes.\n- **[LuxVPS](https://billing.luxvps.net/aff.php?aff=249)** — Best price-to-performance ratio (~€20/mo). Excellent choice for a budget-friendly but powerful trading node (Crypto accepted).\n- **[is*hosting](https://ishosting.com/affiliate/NzU2OCM2)** — Premium hosting with a massive selection of global locations (from $50+/mo). Perfect if you need a server physically close to a specific exchange for lower latency (Crypto accepted).\n\nDeploy a fully configured instance on any Ubuntu 22.04+ server with a single command. The script auto-installs Docker, generates all secrets, configures networking, sets up a firewall, and starts every service.\n\n```bash\ncurl -sL \"https://raw.githubusercontent.com/DepthSight-Pro/DepthSight/main/deploy.sh\" | sudo bash\n```\n\nThe interactive installer will ask for your domain (or default to `\u003cIP\u003e.sslip.io` with auto-SSL via Caddy), and optionally enable Bitcart crypto billing.\n\n### Updating\n\nYou can update DepthSight in two ways:\n\n#### 1. One-Click UI Update (Recommended)\nDepthSight features a secure container-to-host auto-update mechanism:\n* When you click **Update** in the admin web UI, the container writes a `.update_trigger` file into the shared `data/` volume.\n* A host-side cron job (automatically set up by the installer) polls this directory, detects the trigger file, and executes the update script on the host.\n* This allows seamless, zero-downtime updates directly from the web interface without exposing any host or root privileges to the Docker container itself.\n\n#### 2. Manual Update via CLI\nYou can also trigger the update manually by running the host-side script:\n\n```bash\nsudo bash /opt/depthsight/update.sh\n```\n\n### Manual / Local Docker\n\n```bash\ncp .env.example .env\ndocker compose up -d --build\n```\n\nBefore using this outside a local throwaway setup, replace all `change_me_*` secrets in `.env`, especially the Redis ACL passwords and API/JWT/encryption keys.\n\nAfter startup:\n\n- API docs: `http://localhost:8000/docs`\n- Frontend: `http://localhost:5173`\n- PWA: `http://localhost:5174`\n\n## 💖 Support the Project\n\nDepthSight is completely free and open-source. Maintaining a professional-grade trading infrastructure requires significant resources. To keep the project alive and free for everyone, we use exchange broker programs as our primary support mechanism.\n\n**How it works:** By default, the software includes our Broker/Referral IDs for supported exchanges. When you trade using DepthSight, the exchange shares a small portion of their trading fee with us to fund further development. **This costs you absolutely nothing**—your trading fees remain exactly the same as they would be otherwise.\n\nIf you find this project valuable, please consider keeping the default Broker IDs active. \n\nAlternatively, if DepthSight has helped you automate your trading or build your business, you can support us directly via donations:\n- **USDT (TRC-20):** `TJXbcdPuay8o1VKX2PGHzQ6kVtWjd7aDUi`\n- **BTC:** `34GLMAKyzwuXZW9t6gUZhzF3x2gwBmh9uU`\n- **ETH (ERC-20):** `0x83af3385655a3991d01fb9bf831bea4d75d99409`\n\n*Thank you for your support!*\n\n## License \u0026 Commercial Use\n\nDepthSight is released under the **GNU AGPLv3** open-source license. You are free to download, modify, and run this platform for your personal trading. Furthermore, anyone who modifies and runs this software as a service over a network is required to release their modifications under the same AGPLv3 license.\n\n**Dual Licensing for SaaS / Commercial Use:**\nIf you want to build a closed-source fin-tech business or a commercial SaaS offering on top of our infrastructure without open-sourcing your modifications under AGPLv3, you must purchase a commercial license. Please contact `admin@depthsight.pro` for White-Label licensing.\n\n## Repository layout\n\n```text\n/\n|-- api/            FastAPI app, auth, models, websocket server\n|-- bot_module/     Trading engine, strategies, execution, backtesting\n|-- frontend/       Web dashboard\n|-- pwa/            Mobile PWA\n|-- tests/          Automated test suite\n|-- docs/           Public documentation\n\n|-- docker-compose.yml\n|-- requirements.txt\n|-- market_data_service.py\n`-- bot_runner.py\n```\n\n## Services and ports\n\n| Service | Default port | Purpose |\n| --- | ---: | --- |\n| PostgreSQL | 5432 | Persistent storage |\n| Redis | internal only | Cache, state, pub/sub, task broker |\n| API | 8000 | REST API |\n| WebSocket | 8765 | Real-time events |\n| Frontend | 5173 | Web dashboard |\n| PWA | 5174 | Mobile client |\n| Bot | n/a | Trading runtime |\n| Market data | n/a | Central exchange stream fan-out for bot workers |\n| Celery worker | n/a | Background jobs |\n\nRedis is not exposed on the host by default. Compose creates service-level Redis ACL users for `api`, `websocket`, `bot`, `celery`, and `market_data`; each application container connects with its own `REDIS_USERNAME` and password.\n\n\n### Local development\n\n```bash\npython -m venv .venv\n.venv\\Scripts\\activate\npip install -r requirements.txt\ncp .env.example .env\nalembic upgrade head\nuvicorn api.depthsight_api:app --host 0.0.0.0 --port 8000 --reload\nuvicorn api.websocket_server:app --host 0.0.0.0 --port 8765 --reload\npython bot_runner.py\ncelery -A tasks.celery_app worker --loglevel=info --pool=prefork -c 2\n```\n\nOn Unix-like shells, replace `.venv\\Scripts\\activate` with `source .venv/bin/activate`.\n\nFor local development, `MARKET_DATA_FANOUT_MODE=direct` keeps market data inside the bot process and does not require the market-data service. To test the production fan-out path locally, set `MARKET_DATA_FANOUT_MODE=redis`, run Redis, and start the service in a separate terminal:\n\n```bash\npython market_data_service.py\npython bot_runner.py\n```\n\nRun the clients separately when needed:\n\n```bash\ncd frontend\nnpm install\nnpm run dev\n\ncd ..\\pwa\nnpm install\nnpm run dev\n```\n\n## Payments \u0026 Billing (Bitcart)\n\nDepthSight is built to be a fully monetizable SaaS out of the box. It includes a pre-configured `docker-compose.bitcart.yml` file to spin up a self-hosted [Bitcart](https://bitcart.ai/) instance for accepting cryptocurrency payments (BTC, LTC, TRX, BNB, MATIC) without third-party fees.\n\nTo start the billing infrastructure alongside the main app:\n\n```bash\ndocker compose -f docker-compose.bitcart.yml up -d\n```\n\nThe Bitcart services will automatically inherit URLs from your `.env` configuration (e.g., `BITCART_ADMIN_URL`, `BITCART_STORE_URL`, `BITCART_API_URL`). To link the DepthSight backend to your Bitcart store, configure the `BITCART_*` variables in your `.env` file.\n\n## Privacy \u0026 Federation Hub\n\nBy default, DepthSight client nodes connect to the centralized **Federation Hub** to enable shared community features like verified strategy templates, discussion boards, public leaderboard ranking, and the live global node network topology map.\n\nWe take your privacy extremely seriously and adhere to strict privacy-by-design standards:\n- **No Hostname Leakage:** Nodes are identified solely by a randomly generated node UUID (e.g., `DepthSightNode-{uuid}`). Your local machine or server's hostname is never transmitted or registered.\n- **Complete IP Privacy:** The central hub server processes incoming node IP addresses *strictly in-memory* to perform geographical resolution (extracting approximate city, country, and coordinates to draw a node connection on the topology map). **The user's cleartext IP address is immediately discarded and is never stored in the hub database.**\n- **Opt-out of Syncing:** If you want to disable telemetry synchronization to depthsight.pro entirely, you can set `IS_CENTRAL_HUB=true` in your `.env` file, which disables the background heartbeat ping task.\n\n## Environment\n\nCreate `.env` from `.env.example` and set the values for your target environment.\n\nMinimum required values for a local run:\n\n- `POSTGRES_USER`\n- `POSTGRES_PASSWORD`\n- `POSTGRES_DB`\n- `POSTGRES_HOST`\n- `POSTGRES_PORT`\n- `REDIS_HOST`\n- `REDIS_PORT`\n- `REDIS_USERNAME`\n- `REDIS_PASSWORD`\n- `REDIS_API_PASSWORD`\n- `REDIS_WEBSOCKET_PASSWORD`\n- `REDIS_BOT_PASSWORD`\n- `REDIS_CELERY_PASSWORD`\n- `REDIS_MARKET_DATA_PASSWORD`\n- `JWT_SECRET_KEY`\n- `CONFIRMATION_SECRET_KEY`\n- `API_KEY_SECRET`\n- `API_ENCRYPTION_KEY`\n\nIn Docker, the Redis container builds ACL users from the service-specific password variables. The `REDIS_PASSWORD` value is only a fallback used when a service-specific password is not set. For a single-process local Redis without ACLs, leave `REDIS_USERNAME` empty and use `REDIS_PASSWORD` only.\n\nMarket-data mode:\n\n- `MARKET_DATA_FANOUT_MODE=direct`: legacy/simple mode. Bot workers open exchange market-data streams directly.\n- `MARKET_DATA_FANOUT_MODE=redis`: production mode. Bot workers request subscriptions through Redis, while `market_data_service.py` owns exchange WebSocket connections and publishes shared snapshots/events back through Redis.\n\nFor live trading, also set the Binance credentials for the selected environment:\n\n- `ACTIVE_TRADING_ENVIRONMENT`\n- `TRADING_MARKET_TYPE`\n- `TESTNET_BINANCE_*`\n\nUse testnet credentials first.\n\n### Frontend Customization\n\nFor the frontend and PWA, you can customize the application's branding (URLs, support email, etc.) by copying `.env.example` to `.env` in the respective `frontend/` and `pwa/` directories:\n\n- `VITE_APP_URL`\n- `VITE_SUPPORT_EMAIL`\n- `VITE_TELEGRAM_URL`\n\n## Testing\n\nBackend test suite:\n\n```bash\npytest\n```\n\n\u003e **Note on E2E Tests:** Several end-to-end tests interact with live exchange testnets (Binance, Bybit, Bitget, Gate.io, BingX). If you do not provide the respective `TESTNET_*` API keys in your `.env` file (see `.env.example`), these specific tests will gracefully skip. To run the full suite, add your testnet keys.\n\nFrontend checks:\n\n```bash\ncd frontend\nnpm run build\nnpm run lint\n```\n\nPWA build:\n\n```bash\ncd pwa\nnpm run build\n```\n\n## Documentation\n\n- Public setup and contribution guide: [docs/open-source-guide.md](docs/open-source-guide.md)\n- Architectural and API documentation: [DepthSight Docs](https://depthsight.pro/docs/overview)\n\n## Contributing\n\n- Keep changes focused.\n- Add or update tests when behavior changes.\n- Do not commit secrets or generated artifacts.\n- Prefer testnet and paper-trading paths when verifying trading changes.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdepthsight-pro%2Fdepthsight","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdepthsight-pro%2Fdepthsight","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdepthsight-pro%2Fdepthsight/lists"}