docs/START_HERE.md

# Black Dragon AI - Start Here

## Local Link

Open:

```text
http://127.0.0.1:8787/
```

## Start Backend

Double-click:

```text
start-backend.bat
```

Or run:

```powershell
cd "C:\Users\HP\Documents\Codex\2026-05-17\doctype-html-html-lang-en-head"
python backend\server.py
```

## Chrome App Mode

Double-click:

```text
BlackDragon-Chrome-App.bat
```

It starts the backend if needed and opens Black Dragon in Chrome app mode.

## Phone/APK Mode

For a real phone app that does not need your phone connected to your PC, deploy Black Dragon to a public HTTPS backend first. The hosted backend URL is also the website URL.

```text
https://your-black-dragon-server.example.com/
```

The server-first APK should be rebuilt with that HTTPS URL in `android-apk/app/src/main/java/com/sirroky/blackdragon/MainActivity.java`.

Hotspot/LAN mode is only for local testing:

```text
start-backend-lan.bat
http://192.168.137.1:8787/
```

## API Key

The API key is backend-only:

```text
backend_data/secrets.json
```

Do not put the key in `index.html`.

There is no frontend API-key input. Black Dragon AI works only when the backend is running.

## Terms First

The web app and APK both require Terms and Privacy Policy acceptance before chat, memory, notes, PC commands, or antivirus scan actions run.

## File Uploads

Black Dragon scans every selected file through the backend before accepting it as an attachment. Text and image files can be used in chat after scanning. Other scanned files are accepted as metadata attachments.

## Temporary Chat Logs

Each backend chat is also written to:

```text
%TEMP%\BlackDragonChats\
```

## Memory Commands

```text
remember that my name is Roky
what do you remember
forget memory
```

Black Dragon also has a Memory mode where saved memories can be viewed, added, or cleared. It can automatically save simple personal facts when the user clearly states them, such as name or preferences.

## Identity Rule

Questions about the creator of Black Dragon answer:

```text
Sir Roky made me.
```

General questions such as "who made the world" should not trigger the Black Dragon creator answer.

## PC Assistant

Allowed examples:

```text
pc disk space
pc process list
pc network info
open notepad
open calculator
scan Downloads
```

Blocked examples:

```text
delete Windows
format disk
disable firewall
shutdown computer
```

## Notes

Open the Notes mode to save typed notes or draw notes with a mouse, touchpad, stylus, or finger. Notes are stored in the backend database.

## Documents

- `docs/TERMS_AND_CONDITIONS.md`
- `docs/PRIVACY_POLICY.md`
- `LICENSE`
- `docs/APP_DETAILS.md`
- `docs/BLACK_DRAGON_COMPLETE_GUIDE.md`