Installation & User Guide
Everything you need to install AlgoCrucible, connect it to NinjaTrader 8, activate a license, and run a strategy through the full validation pipeline.
Watch the walkthrough
Prefer to watch? These short videos cover getting set up, putting a strategy to the test, and certifying it for a prop firm — or follow the written steps below.
Install & Connect — download, install, and connect to NinjaTrader 8 (~4 min).
Validate a Strategy — Optimize & Walk-Forward, the anti-overfitting core.
Certify for a Prop Firm — Audit, Perturbation, Robustness & pass-probability. Written walkthrough.
1. What you need
- Windows 10 or 11 (64-bit).
- NinjaTrader 8, installed and working. AlgoCrucible drives NinjaTrader's own backtest engine, so NT8 is required. Don't have it yet? The platform is free to download from NinjaTrader and free to use for simulation and backtesting (affiliate link — we may earn a commission if you open an account).
- Historical market data loaded in NinjaTrader for the instruments and timeframes you want to test. Deeper history (2+ years) makes the validation stages meaningful.
- An internet connection for subscription activation (offline lifetime licenses don't need one).
AlgoCrucible works with the
NinjaTrader 8
platform — free to download and free for simulation. For quality historical and real-time market
data, Kinetick offers free
end-of-day data for NinjaTrader users. (NinjaTrader links are affiliate links — we may earn a
commission.)
2. Install AlgoCrucible
- Download the installer from
algocrucible.com (the "Download free" button) — it's
AlgoCrucible-Setup.exe. - (Recommended) Close NinjaTrader 8 before installing. The installer adds a small bridge to NinjaTrader that NT8 compiles on its next launch.
- Run
AlgoCrucible-Setup.exe. It's a per-user install — no administrator prompt. Windows may show a SmartScreen notice for a new app; the publisher is AliceAmbrose Capital Inc. (choose More info → Run anyway if prompted). - The installer installs AlgoCrucible under your user profile and, if NinjaTrader 8 is present,
copies the bridge AddOn into your
Documents\NinjaTrader 8\bin\Custom\folders automatically. - Finish — launch AlgoCrucible from the Start menu (or the desktop icon if you chose it).
Finish the NinjaTrader connection
- Start NinjaTrader 8. It compiles the bridge on startup. If AlgoCrucible later says "not connected," open NinjaTrader's NinjaScript Editor (New → NinjaScript Editor) and press F5 to compile.
- Open a Strategy Analyzer window in NinjaTrader (any configuration — AlgoCrucible sets it up for you). Keeping one Strategy Analyzer window open is the only manual NT8 step.
- Launch AlgoCrucible — it connects automatically. You're ready.
3. First run & onboarding
On first launch, AlgoCrucible opens a 5-step onboarding wizard:
- Welcome — what the app does.
- Connect NinjaTrader — a live check that the bridge is talking to NT8.
- The 6-gate funnel — the validation pipeline explained.
- Pick a practice strategy — it auto-detects NinjaTrader's built-in
SampleMACrossOverso you can try a full run immediately. - "Why did it fail?" playbook — how to read results.
You can reopen this any time from the Guide link in the navigation.
4. Activate a license or trial
Open Account in AlgoCrucible.
- Start the free trial: click Start 7-day trial — unlocks all Trader features for 7 days, no card required (one-time).
- Activate a paid license: paste your key into "Activate a license"
and click Activate.
- Subscription key (from your purchase email, looks like
C95C5230-E363-…) — activates online and stays valid while your subscription is active. - Lifetime/offline key (looks like
AC1-…) — activates instantly, works offline.
- Subscription key (from your purchase email, looks like
Your license is bound to that machine. To move to another computer, click Deactivate on the old machine first, then activate on the new one.
Plans at a glance
| Plan | Price | What you get |
|---|---|---|
| Free | $0 | Optimize, Walk-forward, Audit · up to 3 strategies |
| Trader | $39/mo or $390/yr | Everything in Free + Perturbation, Robustness, Certify, Portfolio · unlimited strategies |
| Studio | $99/mo or $990/yr | Everything in Trader + Export (standalone report HTML/PDF) & Branding |
Buy or upgrade from Account, or on algocrucible.com. Checkout is handled securely by Paddle, our Merchant of Record (which also handles tax/VAT). You can pick monthly or annual at checkout.
5. Using the pipeline
AlgoCrucible validates one strategy through a series of increasingly hard questions. Each stage hands off to the next with one click, carrying your configuration forward.
- Optimize — searches your parameter ranges for an edge. "Is there an edge at all?"
- Walk-forward — rolling in-sample/out-of-sample testing + parameter stability. "Is it stable over time?"
- Audit — locks the winning parameters and judges them on two separate out-of-sample windows. Verdict: ROBUST / marginal / MIRAGE. This is the deploy gate.
- Perturbation (Trader+) — nudges the winning parameters ±10–20% and grades the neighborhood out-of-sample. Catches cliff-edge overfits that look great only at one exact setting.
- Robustness (Trader+) — Monte-Carlo the trade order to reveal drawdown/sequencing risk (fan chart + confidence table).
- Certify (Trader+) — Monte-Carlo your daily P&L through a prop firm's actual rules → a probability of passing, months-to-pass, and estimated fees.
- Deploy — writes the validated parameters out for live use.
Portfolio (Trader+): pick validated strategies from your run history, combine them with contract sizes, and see the correlation matrix, combined stats, and a certified pass-probability for the whole book. Uncorrelated strategies smooth drawdowns — the way to pass faster and bust less.
Reading results
- Every run has a 📊 Analysis view (equity, monthly/weekly breakdowns, trade lists, Monte Carlo, and for portfolios a correlation matrix).
- Certification, Robustness, and Portfolio runs produce a printable report (📄 report). Print/Save-as-PDF works on every plan; Studio adds a "Prepared for…" line and a Download standalone HTML button.
- A strategy that fails the integrity gates (e.g., a not-robust perturbation) is stamped NOT CERTIFIED and export is blocked — that's by design.
6. Updating AlgoCrucible
- Download the latest
AlgoCrucible-Setup.exefrom algocrucible.com. - Fully close AlgoCrucible first. Closing the browser tab isn't enough — the app runs
a small background server. If the installer says "files in use," open
Task Manager → Details, end
AlgoCrucible.exe, then run the installer again. (Newer installers close it for you automatically.) - Run the installer — it upgrades in place. Your license and saved runs are preserved.
7. Uninstalling
- Settings → Apps → AlgoCrucible → Uninstall. (Close AlgoCrucible first if it's running.)
- Your data (license, saved runs) under
%LOCALAPPDATA%\AlgoCrucibleis left in place so a reinstall picks up where you left off. Delete that folder manually for a completely clean slate.
8. FAQ
Do I need NinjaTrader 8?
Yes. AlgoCrucible uses NinjaTrader's own backtest engine for perfect fidelity with any strategy and bar type. It is not affiliated with NinjaTrader.
Does my strategy or trading data get uploaded anywhere?
No. Everything is processed locally on your machine. For subscriptions, only your license key and a non-identifying machine hash are sent to our payment provider to confirm your plan is active. Lifetime/offline licenses send nothing.
The app says "not connected" to NinjaTrader.
Make sure NinjaTrader 8 is running, then open its NinjaScript Editor and press F5 to compile the bridge. Also make sure a Strategy Analyzer window is open. Launch AlgoCrucible again.
Activation says "license key is not valid."
Most often you're on an older version — download and install the latest from algocrucible.com, then activate again. Double-check you copied the whole key (no extra spaces). If it still fails, email support with your order ID.
"Failed to load Python DLL" when I start the app.
You likely copied a loose folder instead of installing. Always run the installer
(AlgoCrucible-Setup.exe) — it sets up the runtime correctly.
"Activation limit reached."
Your plan covers a set number of machines (Trader 2, Studio 3). Click Deactivate on a computer you no longer use, then activate on the new one. Still stuck? Email support and we'll free a seat.
How do I move to a new computer?
On the old machine: Account → Deactivate. On the new machine: install AlgoCrucible and Activate with the same key.
The installer says "files in use."
AlgoCrucible is still running in the background. Task Manager → Details → end
AlgoCrucible.exe, then install again.
Perturbation / Certify / Portfolio are locked.
Those are Trader features. Start the free 7-day trial (Account) or upgrade to Trader.
Do I need to be online?
Subscription licenses check in periodically (with a 14-day offline grace, so short offline stretches are fine). Lifetime/offline licenses never need the internet.
Port 8099 is already in use.
Set the environment variable ALGOCRUCIBLE_PORT to a free port before launching
AlgoCrucible.
Where are my saved runs and license stored?
Under %LOCALAPPDATA%\AlgoCrucible. This survives uninstalls and upgrades.
How do I cancel my subscription?
Use the billing link in your purchase email. You keep access through the end of the paid period. See the Refund Policy.
Can I try before I buy?
Yes — there's a Free tier and a one-time 7-day Trader trial (no card), so you can evaluate the full product before paying. For refunds after a purchase, see the Refund Policy.
Is the pass-probability a guarantee?
No. All outputs are hypothetical, model-based estimates produced under simplifying assumptions. Trading involves substantial risk; nothing in the app is financial advice. Treat certification results as an optimistic ceiling, not a promise.