README.md

metadata

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

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 — 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
Eval Samples	hotepfederales/kush-v82-eval-samples
Telegram Bot	@hotep_llm_bot
Knowledge Base	knowledge.askhotep.ai
Website	askhotep.ai