Flask Code 1.2

• OS: Linux only (shell actions and file paths are Linux-specific)
• Python: 3.10 or later
• Dependencies: Flask 3.0+, PyYAML 6.0+
• Storage: SQLite (auto-created as knowledge.db)
• API Keys: At least one Gemini, Groq, or OpenRouter key required

Core Features

• Multi-Provider AI: Supports Gemini, Groq, and OpenRouter with per-user key management
• REST API: Full HTTP API with JSON in/out for auth, chat, files, knowledge, and settings
• Admin Console: Interactive terminal admin shell runs alongside the HTTP server in the same process
• User Accounts: Registration, login, PIN auth, and per-user settings persisted on disk
• Knowledge Engine: Local Markov-based knowledge base seeded and queryable via /learn
• Shell Actions: AI can run bash commands on the server (Linux only)
• File Handler: Read and write files on the server filesystem from connected clients
• Chat Persistence: Full chat history per user, loadable by PIN, exportable to .txt

Included Modules

• server.py — entry point, HTTP server + admin console
• engine.py — local Markov knowledge engine
• auth.py — user registration and login
• chat_history.py / chat_loader.py — chat persistence
• file_handler.py — file read/write (Linux paths)
• shell_actions.py — bash command runner
• gemini_client.py, groq_client.py, openrouter_client.py — AI backends

1. Install dependencies

pip install -r requirements.txt

2. Create your .apikeys file

key_1: "AIza..."          # Gemini key
key_2: YOUR_API_KEY_HERE  # unused slot
key_3: YOUR_API_KEY_HERE  # unused slot

3. Start the server

# Localhost only (default, safest)
python server.py

# Custom port
python server.py --port 8080

# All interfaces (LAN/remote clients)
python server.py --public --port 5000

# No admin console (pure daemon mode)
python server.py --no-console

All POST bodies are JSON. All responses are JSON with an ok boolean.

Auth

POST /auth/register          { username, password }
POST /auth/login             { username, password }
POST /auth/logout            { username }
POST /auth/change-password   { username, current_password, new_password }
POST /auth/login-pin         { pin }

Chat

POST /chat                   { username, message, model? }
GET  /chat/history?username=<u>
POST /chat/load              { username, pin }
POST /chat/clear             { username }
POST /chat/export            { username }

Files

GET  /files
POST /files/read             { username, filename }
POST /files/read-path        { username, filepath }
POST /files/write            { username, filename, content }
POST /files/save-block       { language, code, filename }
POST /files/clear-outputs    {}

Misc

POST /ping                   { username?, model? }
GET  /health
GET  /models
GET  /clock?username=<u>&model=<m>