knowledge-nexus-local

provenance:github:JaredCluff/knowledge-nexus-local

WHAT THIS AGENT DOES

The Knowledge Nexus Local Agent is a tool designed for securely sharing and searching knowledge within a local network. It allows users to connect different knowledge sources and access them as a unified system. This agent indexes local files, enabling fast semantic searches without relying on external cloud services. It's particularly useful for organizations or individuals who prioritize data privacy and offline access. The agent supports secure communication between nodes and offers a convenient system tray icon for easy management. It's built for those needing a robust, self-contained knowledge management solution. The agent facilitates knowledge sharing and discovery in environments where cloud connectivity is limited or undesirable.

PROBLEM IT SOLVES

This agent solves the problem of needing a secure, offline way to connect and search across multiple local knowledge sources. Instead of manually searching through individual files or relying on cloud-based solutions with potential privacy concerns, users can leverage this agent for a unified and private knowledge management experience.

View Source ↗First seen 2mo agoNot yet hireable

CAPABILITIES & CONSTRAINTS

TECH & STACK

rustcliembeddingssemantic-searchofflinek2klocal-file-indexinglance

README

# Knowledge Nexus Local Agent

A standalone CLI agent for K2K (Knowledge-to-Knowledge) federation, local file indexing, and semantic search. Runs headless as a background service or with an optional system tray icon. Designed to operate fully offline with no cloud dependencies for core functionality.

## Features

- **K2K Federation Protocol** - Connect and share knowledge across nodes using the K2K v1.1 protocol
- **Local File Indexing** - Recursive file walker with configurable watch directories and real-time change detection
- **ONNX Embedding Generation** - Local embedding inference using all-MiniLM-L6-v2, fully offline
- **LanceDB Semantic Search** - Embedded vector database for fast similarity search over indexed documents
- **mDNS/DNS-SD Discovery** - Automatic peer discovery on the local network
- **RSA-256 JWT Authentication** - Secure agent-to-hub authentication
- **System Tray Icon** - Optional system tray integration on macOS and Linux

## Quick Start

### Build from Source

```bash
git clone https://github.com/jaredcluff/knowledge-nexus-local.git
cd knowledge-nexus-local
cargo build --release
```

The binary will be at `target/release/knowledge-nexus-agent`.

### Run

```bash
# Start the agent
./target/release/knowledge-nexus-agent start

# Start without system tray
./target/release/knowledge-nexus-agent start --no-tray

# Run with debug logging
RUST_LOG=knowledge_nexus_agent=debug ./target/release/knowledge-nexus-agent start
```

## Configuration

Configuration follows XDG conventions:

| Platform | Config Path |
|----------|-------------|
| macOS    | `~/Library/Application Support/knowledge-nexus-agent/config.yaml` |
| Linux    | `~/.config/knowledge-nexus-agent/config.yaml` |
| Windows  | `%APPDATA%\knowledge-nexus-agent\config.yaml` |

### Environment Variables

| Variable | Description |
|----------|-------------|
| `K2K_HUB_URL` | WebSocket URL of the Agent Hub |
| `K2K_AUTH_TOKEN` | JWT authentication token |
| `K2K_DEVICE_ID` | Override device ID |
| `RUST_LOG` | Logging filter (e.g., `knowledge_nexus_agent=debug`) |

## K2K Protocol

See the [K2K Protocol Specification](docs/K2K_PROTOCOL.md) for details on the federation protocol.

## License

Apache 2.0 - see [LICENSE](LICENSE) for details.

PUBLIC HISTORY

First discoveredMar 23, 2026

IDENTITY

inferred

Identity inferred from code signals. No PROVENANCE.yml found.

Is this yours? Claim it →

METADATA

platformgithub

first seenMar 20, 2026

last updatedMar 22, 2026

last crawled1 months ago

version—

README BADGE

Add to your README:

![Provenance](https://getprovenance.dev/api/badge?id=provenance:github:JaredCluff/knowledge-nexus-local)