Instructions to use Frankenstein-Labs/Cortex.0 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Notebooks
Google Colab
Kaggle
Local Apps Settings

How to use Frankenstein-Labs/Cortex.0 with llama.cpp:

Install (macOS, Linux)

curl -LsSf https://llama.app/install.sh | sh
# Start a local OpenAI-compatible server with a web UI:
llama serve -hf Frankenstein-Labs/Cortex.0:Q8_0
# Run inference directly in the terminal:
llama cli -hf Frankenstein-Labs/Cortex.0:Q8_0

Install from WinGet (Windows)

winget install llama.cpp
# Start a local OpenAI-compatible server with a web UI:
llama serve -hf Frankenstein-Labs/Cortex.0:Q8_0
# Run inference directly in the terminal:
llama cli -hf Frankenstein-Labs/Cortex.0:Q8_0

Use pre-built binary

# Download pre-built binary from:
# https://github.com/ggerganov/llama.cpp/releases
# Start a local OpenAI-compatible server with a web UI:
./llama-server -hf Frankenstein-Labs/Cortex.0:Q8_0
# Run inference directly in the terminal:
./llama-cli -hf Frankenstein-Labs/Cortex.0:Q8_0

Build from source code

git clone https://github.com/ggerganov/llama.cpp.git
cd llama.cpp
cmake -B build
cmake --build build -j --target llama-server llama-cli
# Start a local OpenAI-compatible server with a web UI:
./build/bin/llama-server -hf Frankenstein-Labs/Cortex.0:Q8_0
# Run inference directly in the terminal:
./build/bin/llama-cli -hf Frankenstein-Labs/Cortex.0:Q8_0

Use Docker

docker model run hf.co/Frankenstein-Labs/Cortex.0:Q8_0

Llama new
LM Studio
Jan
Ollama
How to use Frankenstein-Labs/Cortex.0 with Ollama:
```
ollama run hf.co/Frankenstein-Labs/Cortex.0:Q8_0
```
Unsloth Desktop

How to use Frankenstein-Labs/Cortex.0 with Pi:

Start the llama.cpp server

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf Frankenstein-Labs/Cortex.0:Q8_0

Configure the model in Pi

# Install Pi:
npm install -g @earendil-works/pi-coding-agent
# Add to ~/.pi/agent/models.json:
{
  "providers": {
    "llama-cpp": {
      "baseUrl": "http://localhost:8080/v1",
      "api": "openai-completions",
      "apiKey": "none",
      "models": [
        {
          "id": "Frankenstein-Labs/Cortex.0:Q8_0"
        }
      ]
    }
  }
}

Run Pi

# Start Pi in your project directory:
pi

Docker Model Runner
How to use Frankenstein-Labs/Cortex.0 with Docker Model Runner:
```
docker model run hf.co/Frankenstein-Labs/Cortex.0:Q8_0
```

Lemonade

How to use Frankenstein-Labs/Cortex.0 with Lemonade:

Pull the model

# Download Lemonade from https://lemonade-server.ai/
lemonade pull Frankenstein-Labs/Cortex.0:Q8_0

Run and chat with the model

lemonade run user.Cortex.0-Q8_0

List all available models

lemonade list

Hermes Agent

How to use Frankenstein-Labs/Cortex.0 with Hermes Agent:

Start the llama.cpp server

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf Frankenstein-Labs/Cortex.0:Q8_0

Configure Hermes

# Install Hermes:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
hermes setup
# Point Hermes at the local server:
hermes config set model.provider custom
hermes config set model.base_url http://127.0.0.1:8080/v1
hermes config set model.default Frankenstein-Labs/Cortex.0:Q8_0

Run Hermes

hermes

Atomic Chat

OpenClaw

How to use Frankenstein-Labs/Cortex.0 with OpenClaw:

Start the llama.cpp server

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf Frankenstein-Labs/Cortex.0:Q8_0

Configure OpenClaw

# Install OpenClaw:
npm install -g openclaw@latest
# Register the local server and set it as the default model:
openclaw onboard --non-interactive --mode local \
  --auth-choice custom-api-key \
  --custom-base-url http://127.0.0.1:8080/v1 \
  --custom-model-id "Frankenstein-Labs/Cortex.0:Q8_0" \
  --custom-provider-id llama-cpp \
  --custom-compatibility openai \
  --custom-text-input \
  --accept-risk \
  --skip-health

Run OpenClaw

openclaw agent --local --agent main --message "Hello from Hugging Face"

Cortex.0 / cortex0 /agent.py

Frankenstein-Labs

initial commit

c429240 1 day ago

Raw History Blame Contribute Delete

1.66 kB

"""Assemble the OpenHands agent whose reasoning engine is Cortex.0."""

from __future__ import annotations

from openhands.sdk import Agent, Tool
from openhands.sdk.context.condenser import LLMSummarizingCondenser
from openhands.sdk.context.agent_context import AgentContext

# Importing each tool class registers it in the SDK tool registry.
# Without these imports resolve_tool() raises "not registered".
from openhands.tools.file_editor import FileEditorTool  # noqa: F401
from openhands.tools.glob import GlobTool  # noqa: F401
from openhands.tools.grep import GrepTool  # noqa: F401
from openhands.tools.task_tracker import TaskTrackerTool  # noqa: F401
from openhands.tools.terminal import TerminalTool  # noqa: F401

from cortex0.llm import build_llm
from cortex0.settings import Cortex0Settings


def build_agent(settings: Cortex0Settings) -> Agent:
    """Build an agent driven by Cortex.0.
    The model is not a tool the agent calls: it is the ``llm`` the agent
    reasons with on every turn of the action-perception loop. Tools are handed
    to the model as its own action space.
    """
    llm = build_llm(settings)

    tools = [Tool(name=name) for name in settings.tools]

    # Cortex.0 has a 262k window, but a long agent session still needs
    # condensation so the prompt stays affordable and fast.
    condenser = LLMSummarizingCondenser(llm=llm, max_size=settings.condenser_max_size)

    return Agent(
        llm=llm,
        tools=tools,
        system_prompt=settings.system_prompt(),
        agent_context=AgentContext(
            skills=[],
            system_prompt_filename=None,
        ),
        condenser=condenser,
    )

	"""Assemble the OpenHands agent whose reasoning engine is Cortex.0."""

	from __future__ import annotations

	from openhands.sdk import Agent, Tool
	from openhands.sdk.context.condenser import LLMSummarizingCondenser
	from openhands.sdk.context.agent_context import AgentContext

	# Importing each tool class registers it in the SDK tool registry.
	# Without these imports resolve_tool() raises "not registered".
	from openhands.tools.file_editor import FileEditorTool # noqa: F401
	from openhands.tools.glob import GlobTool # noqa: F401
	from openhands.tools.grep import GrepTool # noqa: F401
	from openhands.tools.task_tracker import TaskTrackerTool # noqa: F401
	from openhands.tools.terminal import TerminalTool # noqa: F401

	from cortex0.llm import build_llm
	from cortex0.settings import Cortex0Settings


	def build_agent(settings: Cortex0Settings) -> Agent:
	"""Build an agent driven by Cortex.0.

	The model is not a tool the agent calls: it is the ``llm`` the agent
	reasons with on every turn of the action-perception loop. Tools are handed
	to the model as its own action space.
	"""
	llm = build_llm(settings)

	tools = [Tool(name=name) for name in settings.tools]

	# Cortex.0 has a 262k window, but a long agent session still needs
	# condensation so the prompt stays affordable and fast.
	condenser = LLMSummarizingCondenser(llm=llm, max_size=settings.condenser_max_size)

	return Agent(
	llm=llm,
	tools=tools,
	system_prompt=settings.system_prompt(),
	agent_context=AgentContext(
	skills=[],
	system_prompt_filename=None,
	),
	condenser=condenser,
	)