KippieSearch
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| embedder | No | Embedder backend, e.g. onnx or hash fallback. | onnx |
| api_token | Yes | Long bearer token for API/MCP authentication. MCP requests must send Authorization: Bearer <api_token>; Home Assistant ingress does not need a token. | |
| nas_roots | No | Explicit NAS path(s) to index, e.g. /share/nas. Leave empty to disable NAS indexing. Do not set to all of /share. | |
| batch_size | No | Embedding batch size. Lower on RAM pressure. | 4 |
| chat_model | No | Chat model preset: gemma3-1b, gemma3-4b, org/repo:file.gguf, or mock. | gemma3-1b |
| chat_n_ctx | No | Chat context size. Keep small on Raspberry Pi. | 2048 |
| chat_top_k | No | Number of retrieved chunks included in the RAG prompt. | 6 |
| throttle_s | No | Indexing throttle in seconds. Increase if Home Assistant becomes slow. | 0.05 |
| max_file_mb | No | Maximum file size to index in MB. | 32 |
| chat_enabled | No | Enable RAG chat. Set false to use search only. | true |
| nas_smb_host | No | SMB server host, e.g. 192.168.1.x. Required only when nas_smb_enabled is true. | |
| onnx_threads | No | ONNX thread count. Lower to leave CPU for Home Assistant. | 2 |
| embedding_dim | No | Embedding dimension: 128, 256, 512, or 768. | 256 |
| chat_n_threads | No | Chat thread count. Leave cores for Home Assistant. | 2 |
| max_seq_length | No | Maximum sequence length for embeddings. | 512 |
| nas_smb_shares | No | SMB share name(s) to read, e.g. home. Required only when nas_smb_enabled is true. | |
| chat_max_tokens | No | Maximum answer length in tokens. | 512 |
| itslearning_url | No | it's learning base URL, e.g. https://<school>.itslearning.com. Required only when itslearning_enabled is true. | |
| nas_smb_enabled | No | Enable SMB fallback when no Home Assistant network mount is available. | false |
| chat_temperature | No | Chat temperature. Lower is more factual. | 0.3 |
| nas_smb_password | No | SMB password. Required only when nas_smb_enabled is true. | |
| nas_smb_username | No | SMB username. Required only when nas_smb_enabled is true. | |
| itslearning_enabled | No | Enable daily it's learning sync. | false |
| itslearning_password | No | it's learning password. Required only when itslearning_enabled is true. | |
| itslearning_username | No | it's learning username. Required only when itslearning_enabled is true. | |
| chat_idle_unload_minutes | No | Idle minutes before unloading the chat model from RAM; 0 keeps it loaded. | 15 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo issues