docs/START_HERE.md

Black Dragon AI - Start Here

Local Link

Open:

http://127.0.0.1:8787/

Start Backend

Double-click:

start-backend.bat

Or run:

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

Chrome App Mode

Double-click:

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.

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:

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

API Key

The API key is backend-only:

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:

%TEMP%\BlackDragonChats\

Memory Commands

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:

Sir Roky made me.

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

PC Assistant

Allowed examples:

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

Blocked examples:

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