Raspberry Pi Zero 2W 및 저엔드 VPS를 대상으로하는 경량 AI 에이전트 런타임. 파일 기반 메모리, MCP 도구 지원, Telegram 통합 - 모든 단일 바이너리.

설치

Shell (Linux / macOS):

기본적으로 ~/.local/bin에 설치한다. NEKO_INSTALL_DIR로 덮음:

** 출처에서:**

빠른 시작

구성

Config는 ~/.neko/config.toml에 살고 있습니다. 중요한 단면도:

환경 변수는 ${VAR_NAME} 구문을 통해 대용됩니다.

클립

특징

OpenResponses 호환 LLM

POST /v1/responses] - OpenAI, Anthropic (proxy를 통해), Ollama 또는 자체 호스팅 모델.

파일 기반 메모리

데이터베이스 없음. 연결 없음. 벡터 상점 없음. Memory is just markdown files — readable, editable, and version-controllable by both humans and agent.

시스템은 ** 2 층 아키텍처를 사용합니다 **:

• memory/MEMORY.md (core memory) - 장기적인 사실과 사용자 선호도, 항상 시스템 프롬프트에 주입. 자동 경고를 가진 2000의 chars에 모자를 씌우는 대리인이 stale 맥락 보다는 오히려 자기 치료에 대리인을 위해 그것을 압축해야 할 때. -memory/YYYY-MM-DD.md (daily logs) — ephemeral session notes.

neko

Lightweight AI agent runtime targeting Raspberry Pi Zero 2W and low-end VPS. File-based memory, MCP tool support, Telegram integration — all in a single binary.

Install

Shell (Linux / macOS):

curl -fsSL https://raw.githubusercontent.com/superhq-ai/neko/main/install.sh | sh

Installs to ~/.local/bin by default. Override with NEKO_INSTALL_DIR:

NEKO_INSTALL_DIR=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/superhq-ai/neko/main/install.sh | sh

From source:

git clone https://github.com/superhq-ai/neko.git
cd neko
cargo build --release
# binary at target/release/neko

Quick start

# Create default config and workspace
neko init

# Or run interactive setup
neko init --interactive

# Edit config (defaults to ~/.neko/config.toml)
neko config edit

# Start the agent gateway
neko start

# Send a test message
neko message "Hello, what can you do?"

Configuration

Config lives at ~/.neko/config.toml. Key sections:

[gateway]
bind = "127.0.0.1:3000"
workspace = "~/.neko/workspace"

[agent]
model = "gpt-5-mini"
provider = "openai"
max_tokens = 4096
tools = ["read_file", "write_file", "list_files", "exec", "http_request", "memory_write"]

[providers.openai]
api_key = "${OPENAI_API_KEY}"
base_url = "https://api.openai.com"

[tools]
sandbox = false
exec_timeout_secs = 1800

# MCP servers
[mcp.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]

Environment variables are substituted via ${VAR_NAME} syntax.

CLI

neko init              Initialize config and workspace
neko init -i           Interactive setup
neko start             Start the gateway server
neko stop              Stop the running gateway
neko status            Show gateway status
neko logs [-l N]       Show recent logs
neko message     Send a message to the agent
neko config show       Print current config
neko config edit       Open config in $EDITOR
neko sessions list     List active sessions
neko sessions clear    Clear all sessions
neko memory list       List memory files
neko memory search Q   Search memory files
neko skills list       List installed skills
neko skills install P  Install a skill from path
neko skills remove N   Remove a skill by name
neko cron list         List all cron jobs
neko cron add  Add a scheduled job
neko cron edit     Edit a cron job
neko cron remove   Remove a cron job
neko cron history      Show execution history

Features

OpenResponses-compatible LLM

Works with any provider exposing POST /v1/responses — OpenAI, Anthropic (via proxy), Ollama, or self-hosted models.

File-based memory