boha_admin
0 Followers · 0 Following
  • Joined on 2026-03-12
Repositories
1
 Projects Packages Public Activity Starred Repositories

@boha/cortex-gateway (2.3.0)

Published 2026-03-22 21:05:23 +01:00 by boha_admin

Installation

@boha:registry=
npm install @boha/cortex-gateway@2.3.0
"@boha/cortex-gateway": "2.3.0"

About this package

Cortex Gateway

Self-hosted Telegram bot that bridges Ollama (LLM brain) and Claude Code (coding hands). An autonomous AI companion with memory, skills, plugins, and self-evolving identity.

Quick Start

# Install
npm config set @boha:registry https://git.boha-automation.cz/api/packages/boha_admin/npm/
npm install -g @boha/cortex-gateway

# Setup
cortex init

# Run
cortex start

Features

  • Telegram bot with 20+ commands, auth whitelist, rate limiting
  • Ollama LLM with 40+ tools (native tool calling)
  • Claude Code integration (async background tasks, session resumption)
  • Plugin system — tools, commands, cron tasks, event hooks
  • Memory — per-user profiles, conversation history, follow-ups
  • Scheduler — cron tasks, reminders, proactive companion behaviors
  • CLI REPL — cortex chat for terminal interaction
  • Deployment profiles — full, companion (chat-only), minimal (no tools)

Commands

cortex init       # Interactive setup wizard
cortex start      # Start Telegram bot
cortex chat       # Interactive CLI REPL
cortex config     # View/modify configuration
cortex validate   # Validate config without starting
cortex --version  # Show version

Configuration

Config lives in cortex.json5 (discovered automatically):

  1. CORTEX_CONFIG_PATH env var
  2. ~/.cortex/cortex.json5
  3. ./runtime/cortex.json5

Profiles

Profile Description
full Chat + coding (Claude Code) + all tools
companion Chat + memory + web + reminders (no coding)
minimal Pure Ollama chat (no tools)

Deploy a standalone instance:

./scripts/deploy.sh /path/to/instance --profile companion

Plugins

Drop a plugin into runtime/plugins/:

my-plugin/
  cortex.plugin.json
  index.js

Plugins can register tools, commands, cron tasks, and event hooks.

Requirements

  • Node.js 20+
  • Ollama (local or remote)
  • Telegram Bot Token (from @BotFather)
  • Claude Code CLI (optional, for coding tasks)

License

MIT — BOHA Automation

Dependencies

Dependencies

ID Version
@anthropic-ai/claude-agent-sdk ^0.2.76
@clack/prompts ^1.1.0
@mozilla/readability ^0.6.0
chalk ^5.6.2
commander ^14.0.3
gray-matter ^4.0.0
jsdom ^29.0.0
json5 ^2.2.3
minimatch ^10.2.4
nanoid ^5.0.0
node-cron ^3.0.0
pino ^9.0.0
pino-abstract-transport ^3.0.0
pino-pretty ^11.0.0
string-width ^8.2.0
telegraf ^4.16.0
zod ^3.25.76

Development Dependencies

ID Version
@types/jsdom ^28.0.0
@types/node ^20.0.0
@types/node-cron ^3.0.0
@typescript-eslint/eslint-plugin ^8.57.1
@typescript-eslint/parser ^8.57.1
eslint ^10.0.3
eslint-config-prettier ^10.1.8
husky ^9.1.7
lint-staged ^16.4.0
prettier ^3.8.1
tsx ^4.0.0
typescript ^5.5.0
vitest ^2.0.0

Keywords

telegram bot ai anthropic claude companion cortex
Details
npm
2026-03-22 21:05:23 +01:00
2
BOHA Automation
MIT
latest
246 KiB
Assets (1)
cortex-gateway-2.3.0.tgz 246 KiB
Versions (16) View all
2.3.0 2026-03-22
2.2.0 2026-03-22
2.1.1 2026-03-21
2.1.0 2026-03-21
2.0.1 2026-03-21