| --- |
| title: "Hotep Intelligence" |
| emoji: "🔥" |
| colorFrom: yellow |
| colorTo: gray |
| sdk: gradio |
| sdk_version: 6.12.0 |
| app_file: app.py |
| pinned: true |
| license: apache-2.0 |
| models: |
| - hotepfederales/hotep-llm-kush-v82-GGUF |
| datasets: |
| - hotepfederales/kush-v82-eval-samples |
| short_description: Live demo for the Kush v82 flagship model |
| --- |
| |
| # Hotep Intelligence |
|
|
| [](https://huggingface.co/hotepfederales/hotep-llm-kush-v82-GGUF) |
| [](https://huggingface.co/datasets/hotepfederales/kush-v82-eval-samples) |
| [](https://askhotep.ai) |
| [](https://t.me/hotep_llm_bot) |
|
|
| Live Hugging Face Space for the **Kush v82** flagship model. |
|
|
| ## Positioning |
|
|
| Hotep Intelligence is a culturally grounded assistant focused on: |
|
|
| - African civilizational history |
| - sovereignty and strategic self-development |
| - disciplined leadership |
| - practical knowledge work |
|
|
| This Space is the public interaction surface for the Hotep ecosystem. It should always direct visitors to the flagship model and the primary product surfaces. |
|
|
| ## How It Runs |
|
|
| - **Default:** a small public model runs on Space hardware so the demo stays live at zero configuration. |
| - **Upgrade path:** set an `HF_INFERENCE_TOKEN` secret and the app routes to the `hotepfederales/hotep-llm-kush-v82-GGUF` flagship through Hugging Face Inference Providers or a dedicated endpoint. |
| - **Local option:** set `HF_LOCAL_BACKEND=llamacpp` and `HF_GGUF_PATH=/path/to/kush-v82.gguf` to run the flagship directly on-device. |
|
|
| ## Configuration Reference |
|
|
| | Space secret / env var | Purpose | |
| | ----------------------------- | ------------------------------------------------------------ | |
| | `HF_INFERENCE_TOKEN` | Auth for Hugging Face Inference Providers / dedicated endpoint | |
| | `HF_MODEL_ID` | Override flagship model id (default: `hotepfederales/hotep-llm-kush-v82-GGUF`) | |
| | `HF_INFERENCE_ENDPOINT_URL` | Dedicated Inference Endpoint URL, if used | |
| | `HF_LOCAL_BACKEND` | `transformers` or `llamacpp` to run locally on Space hardware | |
| | `HF_LOCAL_MODEL_ID` | Local fallback model id (default: `Qwen/Qwen2.5-0.5B-Instruct`) | |
| | `HF_GGUF_PATH` | Path to a local GGUF file when `HF_LOCAL_BACKEND=llamacpp` | |
|
|
| ## Example Prompts |
|
|
| The chat panel ships with 5 canonical Hotep prompts. Broader test coverage lives in the public eval dataset: |
|
|
| - [hotepfederales/kush-v82-eval-samples](https://huggingface.co/datasets/hotepfederales/kush-v82-eval-samples) — 23 samples across 7 categories (history, Ma'at, sovereignty, self-development, tone, knowledge-grounding, refusals) |
|
|
| ## Ecosystem Links |
|
|
| | Resource | Link | |
| | -------------------- | ------------------------------------------------------------------------------------------------------- | |
| | Flagship Model | [hotepfederales/hotep-llm-kush-v82-GGUF](https://huggingface.co/hotepfederales/hotep-llm-kush-v82-GGUF) | |
| | Eval Samples | [hotepfederales/kush-v82-eval-samples](https://huggingface.co/datasets/hotepfederales/kush-v82-eval-samples) | |
| | Telegram Bot | [@hotep_llm_bot](https://t.me/hotep_llm_bot) | |
| | Knowledge Base | [knowledge.askhotep.ai](https://knowledge.askhotep.ai) | |
| | Website | [askhotep.ai](https://askhotep.ai) | |
|
|
