---
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

[![Flagship Model](https://img.shields.io/badge/Flagship-Kush_v82-yellow?style=for-the-badge&logo=huggingface)](https://huggingface.co/hotepfederales/hotep-llm-kush-v82-GGUF)
[![Eval Samples](https://img.shields.io/badge/Eval_Samples-Dataset-blue?style=for-the-badge&logo=huggingface)](https://huggingface.co/datasets/hotepfederales/kush-v82-eval-samples)
[![Website](https://img.shields.io/badge/Site-askhotep.ai-black?style=for-the-badge)](https://askhotep.ai)
[![Telegram](https://img.shields.io/badge/Telegram-@hotep__llm__bot-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white)](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)                                                                      |