Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Empty file added .!31524!banner.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
76 changes: 38 additions & 38 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
<div align="center">
<img src="banner.png" alt="ClaraCore Banner" width="100%">
<img src="banner.png" alt="JarvisCore Banner" width="100%">
</div>

# ClaraCore 🚀
# JarvisCore 🚀

![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
```bash
Expand All @@ -12,70 +12,70 @@ source ~/.bashrc
```

**🛡️ Windows Security Notice**
ClaraCore may be flagged by antivirus software - **this is a false positive**. [Complete guide to antivirus warnings](docs/ANTIVIRUS_FALSE_POSITIVES.md) | [Why is this flagged?](SECURITY_VERIFICATION.md)
JarvisCore may be flagged by antivirus software - **this is a false positive**. [Complete guide to antivirus warnings](docs/ANTIVIRUS_FALSE_POSITIVES.md) | [Why is this flagged?](SECURITY_VERIFICATION.md)

```powershell
# Quick fix - Add Windows Defender exclusion:
Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\ClaraCore"
Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\JarvisCore"

# Or unblock the file:
Unblock-File "$env:LOCALAPPDATA\ClaraCore\claracore.exe"
Unblock-File "$env:LOCALAPPDATA\JarvisCore\jarviscore.exe"

# Or run troubleshooter:
curl -fsSL https://raw.githubusercontent.com/claraverse-space/ClaraCore/main/scripts/troubleshoot.ps1 | powershell
curl -fsSL https://raw.githubusercontent.com/jarvisverse-space/JarvisCore/main/scripts/troubleshoot.ps1 | powershell
```

**✅ Verify it's safe:** Check SHA256 hash against [official releases](https://github.com/claraverse-space/ClaraCore/releases) or [build from source](SECURITY_VERIFICATION.md).
**✅ Verify it's safe:** Check SHA256 hash against [official releases](https://github.com/jarvisverse-space/JarvisCore/releases) or [build from source](SECURITY_VERIFICATION.md).

**Need help?** See our [Setup Guide](docs/SETUP.md) or [Container Guide](docker/CONTAINER_SETUP.md)

## 🙏 Credits & Acknowledgments)
[![Go Version](https://img.shields.io/badge/Go-1.23+-blue.svg)](https://golang.org/)
[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)](https://github.com/prave/ClaraCore)
[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)](https://github.com/prave/JarvisCore)

> **Auto-setup for llama.cpp** - Point it at your GGUF models folder and get a complete AI inference server in seconds.

ClaraCore extends [llama-swap](https://github.com/mostlygeek/llama-swap) with intelligent automation, bringing zero-configuration setup to llama.cpp deployments.
JarvisCore extends [llama-swap](https://github.com/mostlygeek/llama-swap) with intelligent automation, bringing zero-configuration setup to llama.cpp deployments.

## 🔥 Quick Install

### Native Installation

**Linux/macOS (Recommended):**
```bash
curl -fsSL https://raw.githubusercontent.com/claraverse-space/ClaraCore/main/scripts/install.sh | bash
curl -fsSL https://raw.githubusercontent.com/jarvisverse-space/JarvisCore/main/scripts/install.sh | bash
```

**Windows:**
```powershell
irm https://raw.githubusercontent.com/claraverse-space/ClaraCore/main/scripts/install.ps1 | iex
irm https://raw.githubusercontent.com/jarvisverse-space/JarvisCore/main/scripts/install.ps1 | iex
```

**Then start immediately:**
```bash
claracore --models-folder /path/to/your/gguf/models
jarviscore --models-folder /path/to/your/gguf/models
# Visit: http://localhost:5800/ui/setup
```

### 🐳 Docker (CUDA/ROCm)

**CUDA (NVIDIA):**
```bash
docker run -d --gpus all -p 5800:5800 -v ./models:/models claracore:cuda --models-folder /models
docker run -d --gpus all -p 5800:5800 -v ./models:/models jarviscore:cuda --models-folder /models
```

**ROCm (AMD):**
```bash
docker run -d --device=/dev/kfd --device=/dev/dri -p 5800:5800 -v ./models:/models claracore:rocm --models-folder /models
docker run -d --device=/dev/kfd --device=/dev/dri -p 5800:5800 -v ./models:/models jarviscore:rocm --models-folder /models
```

📦 **Optimized containers**: 2-3GB vs 8-12GB full SDKs. See [Container Guide](docker/CONTAINER_SETUP.md)

✨ **Features include:** Auto-setup, hardware detection, binary management, and production configs!

## ✨ What's New in ClaraCore
## ✨ What's New in JarvisCore

While maintaining 100% compatibility with llama-swap, ClaraCore adds:
While maintaining 100% compatibility with llama-swap, JarvisCore adds:

- 🎯 **Auto-Setup Engine** - Automatic GGUF detection and configuration
- 🔍 **Smart Hardware Detection** - CUDA/ROCm/Vulkan/Metal optimization
Expand All @@ -87,9 +87,9 @@ While maintaining 100% compatibility with llama-swap, ClaraCore adds:

```bash
# One command setup - that's it!
./claracore --models-folder /path/to/your/gguf/models --backend vulkan
./jarviscore --models-folder /path/to/your/gguf/models --backend vulkan

# ClaraCore will:
# JarvisCore will:
# 1. Scan for GGUF files
# 2. Detect your hardware (GPUs, CUDA, etc.)
# 3. Download optimal binaries
Expand All @@ -103,12 +103,12 @@ While maintaining 100% compatibility with llama-swap, ClaraCore adds:

**Linux/macOS:**
```bash
curl -fsSL https://raw.githubusercontent.com/claraverse-space/ClaraCore/main/scripts/install.sh | bash
curl -fsSL https://raw.githubusercontent.com/jarvisverse-space/JarvisCore/main/scripts/install.sh | bash
```

**Windows:**
```powershell
irm https://raw.githubusercontent.com/claraverse-space/ClaraCore/main/scripts/install.ps1 | iex
irm https://raw.githubusercontent.com/jarvisverse-space/JarvisCore/main/scripts/install.ps1 | iex
```

The installer will:
Expand All @@ -121,28 +121,28 @@ The installer will:

```bash
# Windows
curl -L -o claracore.exe https://github.com/claraverse-space/ClaraCore/releases/latest/download/claracore-windows-amd64.exe
curl -L -o jarviscore.exe https://github.com/jarvisverse-space/JarvisCore/releases/latest/download/jarviscore-windows-amd64.exe

# Linux
curl -L -o claracore https://github.com/claraverse-space/ClaraCore/releases/latest/download/claracore-linux-amd64
chmod +x claracore
curl -L -o jarviscore https://github.com/jarvisverse-space/JarvisCore/releases/latest/download/jarviscore-linux-amd64
chmod +x jarviscore

# macOS Intel
curl -L -o claracore https://github.com/claraverse-space/ClaraCore/releases/latest/download/claracore-darwin-amd64
chmod +x claracore
curl -L -o jarviscore https://github.com/jarvisverse-space/JarvisCore/releases/latest/download/jarviscore-darwin-amd64
chmod +x jarviscore

# macOS Apple Silicon
curl -L -o claracore https://github.com/claraverse-space/ClaraCore/releases/latest/download/claracore-darwin-arm64
chmod +x claracore
curl -L -o jarviscore https://github.com/jarvisverse-space/JarvisCore/releases/latest/download/jarviscore-darwin-arm64
chmod +x jarviscore
```

### Build from Source

```bash
git clone https://github.com/claraverse-space/ClaraCore.git
cd ClaraCore
git clone https://github.com/jarvisverse-space/JarvisCore.git
cd JarvisCore
python build.py # Builds UI + Go backend with version info
# or: go build -o claracore .
# or: go build -o jarviscore .
```

## 🎛️ Core Features
Expand All @@ -158,7 +158,7 @@ All the power of llama-swap, plus intelligent automation:
- ✅ Docker/Podman support
- ✅ Full llama.cpp server control

### ClaraCore Enhancements
### JarvisCore Enhancements
- ✅ Zero-configuration setup
- ✅ Automatic binary downloads
- ✅ Hardware capability detection
Expand All @@ -171,12 +171,12 @@ All the power of llama-swap, plus intelligent automation:
### Automatic Setup
```bash
# Just point to your models
./claracore --models-folder ~/models
./jarviscore --models-folder ~/models
```
### Manual Setup - for devices like strix halo and others who want to customize or setup without relying on auto-detection
```bash
# Create a config file
./claracore -ram 64 -vram 24 -backend cuda
./jarviscore -ram 64 -vram 24 -backend cuda
# it will download the binaries and create a config file automatically and UI will have all the features needed to manage models
```

Expand All @@ -196,10 +196,10 @@ curl http://localhost:8080/v1/chat/completions \

## 🔧 Configuration

ClaraCore generates configurations automatically, but you can customize everything:
JarvisCore generates configurations automatically, but you can customize everything:

```yaml
# Auto-generated by ClaraCore
# Auto-generated by JarvisCore
models:
"llama-3-70b":
cmd: |
Expand Down Expand Up @@ -258,7 +258,7 @@ curl http://localhost:5800/api/setup/progress

## �🙏 Credits & Acknowledgments

**ClaraCore is built on [llama-swap](https://github.com/mostlygeek/llama-swap) by [@mostlygeek](https://github.com/mostlygeek)**
**JarvisCore is built on [llama-swap](https://github.com/mostlygeek/llama-swap) by [@mostlygeek](https://github.com/mostlygeek)**

This project extends llama-swap's excellent proxy architecture with automatic setup capabilities. Approximately 90% of the core functionality comes from the original llama-swap codebase. We're deeply grateful for @mostlygeek's work in creating such a solid foundation.

Expand Down Expand Up @@ -301,10 +301,10 @@ MIT License - Same as llama-swap. See [LICENSE](LICENSE) for details.

## 🔗 Links

- [ClaraCore Issues](https://github.com/prave/ClaraCore/issues)
- [JarvisCore Issues](https://github.com/prave/JarvisCore/issues)
- [Original llama-swap](https://github.com/mostlygeek/llama-swap)
- [llama.cpp](https://github.com/ggerganov/llama.cpp)
- [Documentation Wiki](https://github.com/prave/ClaraCore/wiki)
- [Documentation Wiki](https://github.com/prave/JarvisCore/wiki)

---

Expand Down
16 changes: 8 additions & 8 deletions RELEASE_MANAGEMENT.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# ClaraCore Release Management
# JarvisCore Release Management

This directory contains automated release management tools for ClaraCore.
This directory contains automated release management tools for JarvisCore.

## 🚀 Quick Release

Expand Down Expand Up @@ -36,11 +36,11 @@ python release.py --version v0.1.0 --token-file .github_token

### Cross-Platform Builds
Automatically builds binaries for:
- Linux x64 (`claracore-linux-amd64`)
- Linux ARM64 (`claracore-linux-arm64`)
- macOS Intel (`claracore-darwin-amd64`)
- macOS Apple Silicon (`claracore-darwin-arm64`)
- Windows x64 (`claracore-windows-amd64.exe`)
- Linux x64 (`jarviscore-linux-amd64`)
- Linux ARM64 (`jarviscore-linux-arm64`)
- macOS Intel (`jarviscore-darwin-amd64`)
- macOS Apple Silicon (`jarviscore-darwin-arm64`)
- Windows x64 (`jarviscore-windows-amd64.exe`)

### Release Automation
- Creates GitHub release with proper versioning
Expand Down Expand Up @@ -154,7 +154,7 @@ curl -H "Authorization: token ghp_your_token" https://api.github.com/rate_limit
### Network Issues
```bash
# Test GitHub connectivity
curl https://api.github.com/repos/badboysm890/ClaraCore
curl https://api.github.com/repos/badboysm890/JarvisCore

# Use proxy if needed
export HTTPS_PROXY=http://proxy:port
Expand Down
34 changes: 17 additions & 17 deletions SECURITY_VERIFICATION.md
Original file line number Diff line number Diff line change
@@ -1,39 +1,39 @@
# 🔒 Security Verification Guide

## Why is ClaraCore Flagged by Antivirus?
## Why is JarvisCore Flagged by Antivirus?

**ClaraCore is 100% safe and open source.** Antivirus software flags it because it:
**JarvisCore is 100% safe and open source.** Antivirus software flags it because it:
1. Downloads AI model binaries from llama.cpp (legitimate ML tool)
2. Spawns subprocesses to run AI models
3. Self-heals by downloading missing components

These are **normal behaviors for AI inference tools**, but trigger heuristic detection.

## ✅ Verify ClaraCore is Legitimate
## ✅ Verify JarvisCore is Legitimate

### Method 1: Check SHA256 Hash (Recommended)

**Windows:**
```powershell
# Calculate hash of your downloaded file
Get-FileHash claracore.exe -Algorithm SHA256
Get-FileHash jarviscore.exe -Algorithm SHA256

# Compare with official release hash at:
# https://github.com/claraverse-space/ClaraCore/releases
# https://github.com/jarvisverse-space/JarvisCore/releases
```

**Linux/macOS:**
```bash
sha256sum claracore
sha256sum jarviscore
# Compare with official release hash
```

### Method 2: Build from Source (Ultimate Trust)

```bash
# Clone and inspect the code yourself
git clone https://github.com/claraverse-space/ClaraCore.git
cd ClaraCore
git clone https://github.com/jarvisverse-space/JarvisCore.git
cd JarvisCore

# Review the code (it's all open source!)
# Then build it yourself
Expand All @@ -43,7 +43,7 @@ python build.py
### Method 3: VirusTotal Scan

1. Visit https://www.virustotal.com
2. Upload your `claracore.exe`
2. Upload your `jarviscore.exe`
3. Check that major vendors (Microsoft, Kaspersky, etc.) show it as clean
4. Some generic heuristic engines may flag it - this is normal

Expand All @@ -53,14 +53,14 @@ python build.py
1. Open Windows Security
2. Virus & threat protection → Manage settings
3. Exclusions → Add an exclusion
4. Add folder: `%LOCALAPPDATA%\ClaraCore`
4. Add folder: `%LOCALAPPDATA%\JarvisCore`

**Option B - PowerShell (Admin required):**
```powershell
Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\ClaraCore"
Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\JarvisCore"
```

## 📝 What ClaraCore Does NOT Do
## 📝 What JarvisCore Does NOT Do

- ❌ Does NOT modify Windows Registry
- ❌ Does NOT access system files
Expand All @@ -69,7 +69,7 @@ Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\ClaraCore"
- ❌ Does NOT modify system settings
- ❌ Does NOT install services or drivers

## 🔍 What ClaraCore DOES Do
## 🔍 What JarvisCore DOES Do

- ✅ Downloads llama.cpp binaries from official GitHub releases
- ✅ Creates config files in its own directory
Expand All @@ -78,7 +78,7 @@ Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\ClaraCore"

## 🏢 For Enterprise/Corporate Users

If your IT department blocks ClaraCore:
If your IT department blocks JarvisCore:

1. **Submit to your security team for review** - The code is open source
2. **Build from source** - Your security team can audit the code
Expand All @@ -87,9 +87,9 @@ If your IT department blocks ClaraCore:

## 📧 Still Concerned?

- 🔍 Review the source code: https://github.com/claraverse-space/ClaraCore
- 💬 Open an issue: https://github.com/claraverse-space/ClaraCore/issues
- 📖 Read the documentation: https://github.com/claraverse-space/ClaraCore/blob/main/README.md
- 🔍 Review the source code: https://github.com/jarvisverse-space/JarvisCore
- 💬 Open an issue: https://github.com/jarvisverse-space/JarvisCore/issues
- 📖 Read the documentation: https://github.com/jarvisverse-space/JarvisCore/blob/main/README.md

## 🎯 Why We Don't Code Sign

Expand Down
Loading