Skip to main content

A lightweight personal AI assistant framework

Project description

Kyber Logo

Your new favorite AI assistant.

Set up in 60 seconds. Chat from Discord, Telegram, WhatsApp, the web dashboard, or the command line.

PyPI Docs License: MIT

Install In 60 Seconds

curl -fsSL https://kyber.chat/install.sh | bash

Installer flow:

  • Detects macOS, Linux, and WSL automatically
  • Installs dependencies and kyber-chat
  • Guides provider + model configuration
  • Writes secure local config and .env
  • Optionally sets up service mode

Why Kyber

Most assistants are fine for simple Q&A, then fall apart when the real work starts. Kyber is built for actual execution: it can run multi-step tasks, keep you updated while it works, and stay responsive to new messages without getting stuck. You get the speed of chat plus the reliability of a real automation runtime.

  • Fast setup One command to install, configure, and run
  • Actually concurrent Long-running tasks do not block new messages
  • Background execution Start complex work and keep chatting
  • Chat anywhere Discord, Telegram, WhatsApp, dashboard, or CLI
  • Tooling built in Shell, file I/O, web search/fetch, cron, notebook, remote tools, and skills
  • Runs anywhere Laptop, VPS, homelab, Raspberry Pi
  • Multi-machine aware Pair machines, run commands remotely, and share notes across your fleet
  • Observable Real-time task status, progress, and cancellation
  • Secure by default Secrets in .env, not raw config JSON

What You Can Do

Build and Ship

  • Read, edit, and refactor code across repositories
  • Run shell commands for build/test/deploy workflows
  • Debug failures with iterative tool use and live status updates

Research and Decide

  • Search and fetch web sources
  • Extract and summarize articles/docs/transcripts
  • Pull structured outputs for reports and planning

Automate Repetitive Work

  • Schedule recurring tasks with cron
  • Send proactive updates into your channels
  • Keep workflows running without babysitting

Work Across Machines

  • Pair your laptop and VPS so one Kyber can reach the other
  • Run remote commands and inspect files on connected peers
  • Share durable notes through the built-in notebook

Operate Confidently

  • Track active and completed tasks in the dashboard
  • Cancel misfired tasks from UI or API
  • Review security scan findings and history

Provider Flexibility

Kyber works with:

  • OpenAI
  • Anthropic
  • OpenRouter
  • DeepSeek
  • Any OpenAI-compatible endpoint

You can select the provider/model during onboarding and change it later from the dashboard.

Real Workflow Examples

Debug a Production Bug

you: "login endpoint fails on invalid passwords, find and fix it"
kyber: reads code -> isolates validation bug -> patches -> runs tests -> reports diff

Research + Action

you: "summarize latest API changes and open PRs that need migration updates"
kyber: fetches sources -> summarizes impact -> edits files -> opens actionable checklist

Proactive Ops

you: "check inboxes every 30 minutes and send urgent items to Discord"
kyber: schedules cron -> runs checks -> posts concise summaries on schedule

Dashboard Highlights

  • Live chat with your running agent
  • Task timeline with progress + status
  • Cancel/redeliver controls
  • Provider/model configuration
  • Cron job management
  • Skills discovery and installation
  • Notebook visibility across paired machines
  • Security scan controls and report views

Dashboard Preview

Web Chat

Kyber Dashboard Web Chat

Providers

Kyber Dashboard Providers

Agent

Kyber Dashboard Agent Settings

Cron Jobs

Kyber Dashboard Cron Jobs

Skills

Kyber Dashboard Skills

Security Center

Kyber Dashboard Security Center

Discord Bot Personas

Kyber Dashboard Discord Bot Personas

What’s New in the Current Architecture

Kyber now supports a host/spoke network model for paired machines. Your laptop can talk to a VPS, a VPS can expose a notebook and selected tools, and the agent can choose whether work should happen locally, remotely, or as shared context. The command surface is broader too, with notebook tools, remote execution primitives, and richer CLI/TUI plumbing alongside the original local shell/file/web toolkit.

Security And Reliability

  • Secrets are stored in .env with locked permissions
  • Task lifecycle is tracked (queued, running, completed, failed, cancelled)
  • Cancellations are propagated back to the originating channel
  • Web tooling includes clearer diagnostics for DNS/SSL/timeout failures

Project Links

Contributing

Issues, PRs, and feature proposals are welcome. If you are unsure where to start, open an issue with:

  • Use case
  • Desired behavior
  • Current behavior
  • Logs/screenshots

License

MIT

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kyber_chat-2026.4.21.68.tar.gz (924.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

kyber_chat-2026.4.21.68-py3-none-any.whl (941.4 kB view details)

Uploaded Python 3

File details

Details for the file kyber_chat-2026.4.21.68.tar.gz.

File metadata

  • Download URL: kyber_chat-2026.4.21.68.tar.gz
  • Upload date:
  • Size: 924.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.11

File hashes

Hashes for kyber_chat-2026.4.21.68.tar.gz
Algorithm Hash digest
SHA256 9d77b2b41d900ba7758f61bf14af5c056ddae172846cb3e84752450b4e0c9dfa
MD5 1286d00d2d940e7e080d8a191c0bb3e9
BLAKE2b-256 a5a6dad020a0b57541b1d497a2f17843e4851f24ebf8be6378e3e88a46008289

See more details on using hashes here.

File details

Details for the file kyber_chat-2026.4.21.68-py3-none-any.whl.

File metadata

File hashes

Hashes for kyber_chat-2026.4.21.68-py3-none-any.whl
Algorithm Hash digest
SHA256 970e7ec049cf027ed57de92cef4515f3a3aa7438c6a8de4ea25f2fda69fe0d3c
MD5 81b8ebb08a31489b4ea8bb22cdfb1e7a
BLAKE2b-256 1ab90f8ee4a4e2dca7754ac267021f0a6695bf9c4ea54822faaa51f9b0f5befc

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page