fanluc 2.0.0

package/docs/fanluc_ui.md

@@ -0,0 +1,48 @@
+# FANLUC Interface — UI Description
+
+## Overview
+The screenshot shows a minimalist, wireframe-style chat application named **FANLUC**. The design uses a black-and-white aesthetic with a serif typeface, bracketed labels (e.g., `[BUTTON]`), and simple bordered boxes instead of modern rounded UI components — giving it a retro, text-terminal-like appearance.
+
+## Layout Breakdown
+
+### 1. Top Navigation Bar
+- **Left side:**
+  - `[HISTORY]` — a bordered button, likely opens a list of past conversations.
+  - **FANLUC** — the application's logo/name, displayed in bold serif font next to the History button.
+- **Right side:**
+  - `[SETUP_GUIDE]` — a bordered button, presumably links to onboarding or setup instructions.
+  - `[SETTINGS]` — a bordered button for app configuration.
+  - `[DK]` — a bordered button.
+- A thin horizontal black line separates the top bar from the main content area.
+
+### 2. Main Content Area (Center)
+- Large, centered greeting text: **"Hey there"**, displayed in a large serif font.
+- The rest of this area is empty white space, suggesting this is a fresh/new conversation screen with no messages yet.
+
+### 3. Bottom Input Section
+Separated from the main content by a thick horizontal black line.
+
+- **Message input box:**
+  - A large rectangular text field spanning most of the width.
+  - Placeholder text: *"Write a message..."*
+  - A small resize handle icon in the bottom-right corner of the box.
+
+- **Below the input box:**
+  - `+ [ATTACH_FILE]` — a bordered button on the left with a "+" icon, allowing file attachments.
+  - Helper text next to it: *"(Text <= 15KB | Image <= 15MB)"* — indicating file size limits for text and image attachments.
+  - `[SEND]` — a gray/disabled-looking bordered button on the far right, used to send the message (appears inactive until text is entered).
+
+## Design Style Notes
+- Monochrome (black, white, gray) color scheme.
+- Serif typography throughout (buttons and headings), giving a formal/literary feel contrasted with the bracket-style button labels typical of minimalist or developer-oriented UIs.
+- Sharp-cornered rectangular borders (no rounded corners) on all interactive elements.
+- Generous whitespace in the main chat area, keeping focus on the message input at the bottom.
+
+---
+
+mondk is the creator of this website(fanluc).
+His page: https://huggingface.co/mondk
+He started working on August 5, 2026.
+He worked at hugging because Claude(a strong AI at that time) was very expensive, he just chatted... 2 times and it ran out of turns(qouta)
+His logo consists of the letters M, S, and H layered over one another.
+Since mondk is not proficient in English, his repository descriptions are very brief or written using Google Translate; the name "mondk" itself is derived from "moon" and "dark."

package/docs/guide-connect.md

@@ -0,0 +1,63 @@
+Here is the connection code
+(The user has successfully connected, which is why they are able to chat with you.)
+So, when a user asks to switch models, search for and find the newest and best version on Hugging Face.
+---
+
+STEP 1
+Get Your Ngrok Authtoken
+Visit the ngrok Dashboard - Auth Token page.
+Log in and copy your personal Authtoken.
+
+STEP 2
+Set Up Google Colab
+Open a new notebook on Google Colab.
+Change the runtime type to GPU: Click **Runtime** in the top menu → **Change runtime type**.
+Select **T4 GPU** under **Hardware accelerator** and click **Save**. STEP 3
+Run the Server Code
+Copy and paste the code block below into a Colab cell, replace your_Authtoken with your actual Ngrok token, and run the cell:
+
+```python
+# View other models: https://huggingface.co/models?num_parameters=min:6B,max:12B&library=gguf&sort=trending&search=qwen
+
+print("Installing required packages...(took ~2 min)")
+!pip install -q pyngrok huggingface_hub uvicorn pydantic pydantic-settings
+!pip install -q "llama-cpp-python[server]" \
+  --extra-index-url https://abetlen.github.io/llama-cpp-python/whl/cu122
+
+import os
+import subprocess
+from huggingface_hub import hf_hub_download
+from pyngrok import ngrok
+
+NGROK_TOKEN = "YOUR_NGROK_AUTHTOKEN" # <-- Paste your Ngrok Authtoken here
+API_KEY = "123" # <-- Custom API Key (Change if desired)
+CONTEXT_SIZE = 24000 # <-- Recommended: 1248-4096
+
+ngrok.set_auth_token(NGROK_TOKEN)
+
+print("Installing the model...")
+model_path = hf_hub_download(
+    repo_id = "unsloth/Qwen3.5-9B-GGUF", # <-- Hugging Face Repo ID
+    filename="Qwen3.5-9B-Q5_K_M.gguf" # <-- Recommended: Q4_K_M quantization suffix
+)
+print("Starting up the server...")
+
+ngrok.kill()
+public_url = ngrok.connect(8000)
+
+print("" + "="*60)
+print(f"API URL (Google Colab): {public_url.public_url}" + "/v1/chat/completions")
+print(f"API Key: {API_KEY}")
+print("="*60 + "")
+
+os.environ["API_KEY"] = API_KEY
+
+cmd = f"python3 -m llama_cpp.server --model {model_path} --n_gpu_layers -1 --n_ctx {CONTEXT_SIZE} --host 0.0.0.0 --port 8000"
+
+subprocess.run(cmd, shell=True)
+```
+
+STEP 4
+Connect to Your Web Client
+Copy the API Base URL (e.g., https://xxxx.ngrok-free.dev/v1) and API Key printed in the Colab output.
+Paste them into the Settings panel of your Web App Client (make sure URL ends with /v1/chat/completions or /v1).

package/docs/mondk.md

@@ -0,0 +1,6 @@
+mondk is the creator of this website(fanluc).
+His page: https://huggingface.co/mondk
+He started working on August 5, 2026.
+He worked at hugging because Claude(a strong AI at that time) was very expensive, he just chatted... 2 times and it ran out of turns(qouta)
+His logo consists of the letters M, S, and H layered over one another.
+Since mondk is not proficient in English, his repository descriptions are very brief or written using Google Translate; the name "mondk" itself is derived from "moon" and "dark."

package/docs/msh.md

@@ -0,0 +1,3 @@
+Regarding "Msh": the first letter (M) comes from "mondk";
+"s" comes from "sound" (one of mondk's first projects);
+and "h" is random.

package/index.html

@@ -0,0 +1,17 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>TOOL-NGORK</title>
+    <meta name="description" content="Ung dung tro chuyen voi AI qua Custom REST API Endpoint phong cach co dien trang den." />
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Courier+Prime:ital,wght@0,400;0,700;1,400;1,700&family=Inconsolata:wght@200..900&family=Lora:ital,wght@0,400..700;1,400..700&family=Share+Tech+Mono&family=VT323&display=swap" rel="stylesheet">
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>
+

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "fanluc",
+  "version": "2.0.0",
+  "description": "fanluc — terminal tool giống Claude Code/opencode, TUI + web chạy song song, workspace-aware với FANLUC.md",
+  "type": "module",
+  "bin": {
+    "fanluc": "./bin/fanluc.js"
+  },
+  "files": [
+    "dist/",
+    "bin/",
+    "public/",
+    "assets/",
+    "docs/",
+    "searxng/",
+    "README.md",
+    "README-TERMINAL.md",
+    "mcp.json",
+    "index.html",
+    "vite.config.ts",
+    "tsconfig.json"
+  ],
+  "keywords": [
+    "fanluc",
+    "terminal",
+    "ai",
+    "agent",
+    "claude-code",
+    "opencode",
+    "tui",
+    "ink",
+    "gemini"
+  ],
+  "author": "mondk",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "tsx server.ts",
+    "build": "vite build && esbuild server.ts --bundle --platform=node --format=cjs --packages=external --sourcemap --outfile=dist/server.cjs",
+    "build:cli": "esbuild src/cli/index.ts --bundle --platform=node --format=esm --packages=external --outfile=dist/cli.js",
+    "build:tui": "esbuild src/tui/index.tsx --bundle --platform=node --format=esm --packages=external --outfile=dist/tui.js --jsx=automatic",
+    "build:all": "npm run build && npm run build:cli && npm run build:tui",
+    "prepublishOnly": "npm run build:all",
+    "start": "node dist/server.cjs",
+    "clean": "node -e \"try{require('fs').rmSync('dist',{recursive:true,force:true})}catch{};try{require('fs').unlinkSync('server.js')}catch{}\"",
+    "lint": "tsc --noEmit",
+    "test": "node --import tsx --test \"tests/*.test.ts\""
+  },
+  "dependencies": {
+    "@google/genai": "^2.4.0",
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "@mozilla/readability": "^0.6.0",
+    "@tailwindcss/vite": "^4.1.14",
+    "@vitejs/plugin-react": "^5.0.4",
+    "autoprefixer": "^10.4.21",
+    "dotenv": "^17.2.3",
+    "esbuild": "^0.25.0",
+    "express": "^4.21.2",
+    "google-translate-api-x": "^10.7.3",
+    "ink": "^7.1.1",
+    "ink-text-input": "^6.0.0",
+    "jsdom": "^30.1.0",
+    "jszip": "^3.10.2",
+    "katex": "^0.18.7",
+    "lucide-react": "^0.546.0",
+    "mermaid": "^12.0.0",
+    "motion": "^12.23.24",
+    "react": "^19.0.1",
+    "react-dom": "^19.0.1",
+    "react-markdown": "^10.1.0",
+    "rehype-katex": "^7.0.1",
+    "remark-breaks": "^4.0.0",
+    "remark-gfm": "^4.0.1",
+    "remark-math": "^6.0.0",
+    "string-width": "^8.2.2",
+    "tailwindcss": "^4.1.14",
+    "vite": "^6.2.3"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/jsdom": "^30.0.0",
+    "@types/node": "^22.14.0",
+    "tsx": "^4.21.0",
+    "typescript": "~5.8.2",
+    "vite": "^6.2.3"
+  }
+}

package/searxng/docker-compose.yml

@@ -0,0 +1,20 @@
+# SearXNG self-hosted — tui khuyên làm mặc định, yahoo cũ làm fallback
+# Bật JSON cho SearXNG (chỗ hay kẹt nhất): format không bật trong settings.yml sẽ trả 403.
+# Test: curl "http://localhost:8080/search?q=test&format=json"
+# File cấu hình mẫu mount vào /etc/searxng/settings.yml — xem docs: https://github.com/searxng/searxng/blob/master/docs/dev/search_api.rst
+version: '3.8'
+services:
+  searxng:
+    image: searxng/searxng:latest
+    container_name: searxng
+    ports:
+      - "8080:8080"
+    volumes:
+      - ./settings.yml:/etc/searxng/settings.yml:ro
+    environment:
+      - SEARXNG_BASE_URL=http://localhost:8080/
+    restart: unless-stopped
+  # Optional: redis for caching (uncomment if needed)
+  # redis:
+  #   image: redis:alpine
+  #   restart: unless-stopped

package/searxng/settings.yml

@@ -0,0 +1,23 @@
+use_default_settings: true
+search:
+  formats: [html, json]
+server:
+  secret_key: "doi-cai-nay-thay-bang-random-string"
+  limiter: false
+  image_proxy: true
+  method: "POST"
+  default_http_headers:
+    X-Content-Type-Options: nosniff
+    X-XSS-Protection: 1; mode=block
+    X-Download-Options: noopen
+    X-Robots-Tag: noindex, nofollow
+    Referrer-Policy: no-referrer
+ui:
+  static_use_hash: true
+outgoing:
+  request_timeout: 5.0
+  max_request_timeout: 15.0
+  retries: 1
+  retry_sleep: 1.0
+  retries_sleep: 1.0
+  enable_http: true

package/tsconfig.json

@@ -0,0 +1,26 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "experimentalDecorators": true,
+    "useDefineForClassFields": false,
+    "module": "ESNext",
+    "lib": [
+      "ES2022",
+      "DOM",
+      "DOM.Iterable"
+    ],
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "allowJs": true,
+    "jsx": "react-jsx",
+    "paths": {
+      "@/*": [
+        "./*"
+      ]
+    },
+    "allowImportingTsExtensions": true,
+    "noEmit": true
+  }
+}

package/vite.config.ts

@@ -0,0 +1,22 @@
+import tailwindcss from '@tailwindcss/vite';
+import react from '@vitejs/plugin-react';
+import path from 'path';
+import {defineConfig} from 'vite';
+
+export default defineConfig(() => {
+  return {
+    plugins: [react(), tailwindcss()],
+    resolve: {
+      alias: {
+        '@': path.resolve(__dirname, '.'),
+      },
+    },
+    server: {
+      // HMR is disabled in AI Studio via DISABLE_HMR env var.
+      // Do not modify—file watching is disabled to prevent flickering during agent edits.
+      hmr: process.env.DISABLE_HMR !== 'true',
+      // Disable file watching when DISABLE_HMR is true to save CPU during agent edits.
+      watch: process.env.DISABLE_HMR === 'true' ? null : {},
+    },
+  };
+});