Installation Guide¶

Get F3L1X up and running on your Windows computer in just a few minutes.

System Requirements¶

Before installing, make sure your computer meets these requirements:

For Local AI Features (Optional)¶

If you want to run AI models locally:

Note: F3L1X works great without a dedicated graphics card. Local AI will use your CPU, which is slower but fully functional.

Download F3L1X¶

1. Sign in to your F3L1X account at f3l1x.tech/auth
2. Go to the Download page
3. Click "Download for Windows"

The installer is approximately 150 MB and includes everything you need:
- Core F3L1X application
- 18 production-ready realms
- Embedded runtime (no additional software needed)
- Dashboard and terminal interfaces

Installation Steps¶

Step 1: Run the Installer¶

1. Find the downloaded file: F3L1X-Installer.exe
2. Right-click and select "Run as administrator"
3. If Windows shows a security warning, click "More info" then "Run anyway"

Step 2: Follow the Setup Wizard¶

The installer will guide you through:

1. Welcome Screen - Click "Next" to begin
2. License Agreement - Review and accept the terms
3. Installation Location - Choose where to install (default is recommended)
4. Component Selection - Select which features to install
5. Install - Wait for installation to complete (2-5 minutes)
6. Finish - Optionally launch F3L1X immediately

Step 3: Activate Your Device¶

When F3L1X launches for the first time:

1. You'll see an Activation Screen with a 6-digit code
2. Go to f3l1x.tech/activate in your browser
3. Sign in with your F3L1X account
4. Enter the 6-digit code
5. Your F3L1X will automatically unlock

This links your installation to your account and ensures only you can use it.

Verify Installation¶

To make sure everything is working:

1. Open F3L1X from the Start Menu
2. The Dashboard should open in your browser
3. Say "hello f3l1x" in the terminal
4. You should see a welcome message with your status

Expected output:

═══════════════════════════════════════════
  F3L1X Session Greeting
═══════════════════════════════════════════

Services Status:
  ✓ Dashboard ............. Running
  ✓ Herald ................ Running
  ✓ Documentation ......... Running

Active Blockers: 0
Last Session: (new installation)

Suggested Action: Explore the Dashboard
═══════════════════════════════════════════

Troubleshooting Installation¶

"Windows Protected Your PC" Warning¶

This is normal for new software. Click "More info" then "Run anyway". F3L1X is safe to install.

Installation Fails¶

Try these steps:
1. Run the installer as Administrator
2. Temporarily disable antivirus software
3. Make sure you have enough disk space
4. Restart your computer and try again

Dashboard Won't Open¶

1. Check that F3L1X services are running (look for the system tray icon)
2. Try opening your browser and going to localhost:8000
3. Restart F3L1X from the Start Menu

Activation Code Not Working¶

1. Make sure you're signed in to the correct account
2. Check that the code hasn't expired (codes are valid for 15 minutes)
3. Request a new code by restarting F3L1X

Updating F3L1X¶

F3L1X will notify you when updates are available. To update:

1. Click the update notification in the Dashboard
2. Follow the prompts to download and install
3. F3L1X will restart automatically

Uninstalling F3L1X¶

To remove F3L1X from your computer:

1. Open Settings > Apps > Apps & features
2. Find F3L1X in the list
3. Click Uninstall and follow the prompts

Your data and projects remain on your computer unless you choose to delete them.

Next Steps¶

Now that F3L1X is installed:

• Quick Start Guide - Get productive in 10 minutes
• Understanding Realms - Learn how F3L1X works
• CLI Commands - Master the command line