Metadata-Version: 2.4
Name: kyber-chat
Version: 2026.4.21.68
Summary: A lightweight personal AI assistant framework
Author: kyber contributors
Project-URL: Homepage, https://kyber.chat
Project-URL: Documentation, https://docs.kyber.chat
Project-URL: Repository, https://github.com/cyph3rasi/kyber/
Project-URL: Issues, https://github.com/cyph3rasi/kyber/issues
Keywords: ai,agent,chatbot
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.9.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pydantic-settings>=2.0.0
Requires-Dist: websockets>=12.0
Requires-Dist: websocket-client>=1.6.0
Requires-Dist: httpx>=0.25.0
Requires-Dist: loguru>=0.7.0
Requires-Dist: readability-lxml>=0.8.0
Requires-Dist: rich>=13.0.0
Requires-Dist: prompt_toolkit>=3.0
Requires-Dist: croniter>=2.0.0
Requires-Dist: fastapi>=0.115.0
Requires-Dist: uvicorn>=0.30.0
Requires-Dist: python-telegram-bot>=21.0
Requires-Dist: discord.py>=2.4.0
Requires-Dist: mcp>=1.17.0
Requires-Dist: cisco-ai-skill-scanner>=0.1.0
Requires-Dist: openhands-sdk>=1.11.4
Requires-Dist: openhands-tools>=1.11.4
Requires-Dist: textual>=0.80
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Dynamic: license-file

<p align="center">
  <img src="kyber_logo.png" alt="Kyber Logo" width="420">
</p>

<h1 align="center">Your new favorite AI assistant.</h1>

<p align="center">
  Set up in 60 seconds. Chat from Discord, Telegram, WhatsApp, the web dashboard, or the command line.
</p>

<p align="center">
  <a href="https://pypi.org/project/kyber-chat/"><img alt="PyPI" src="https://img.shields.io/pypi/v/kyber-chat?label=PyPI&color=0f766e"></a>
  <a href="https://docs.kyber.chat"><img alt="Docs" src="https://img.shields.io/badge/docs-kyber.chat-7c3aed"></a>
  <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-16a34a"></a>
</p>

## Install In 60 Seconds

```bash
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
```text
you: "login endpoint fails on invalid passwords, find and fix it"
kyber: reads code -> isolates validation bug -> patches -> runs tests -> reports diff
```

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

### Proactive Ops
```text
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](.github/assets/readme/webchat.png)

### Providers
![Kyber Dashboard Providers](.github/assets/readme/providers.png)

### Agent
![Kyber Dashboard Agent Settings](.github/assets/readme/agent.png)

### Cron Jobs
![Kyber Dashboard Cron Jobs](.github/assets/readme/cronjobs.png)

### Skills
![Kyber Dashboard Skills](.github/assets/readme/skills.png)

### Security Center
![Kyber Dashboard Security Center](.github/assets/readme/securitycenter.png)

### Discord Bot Personas
![Kyber Dashboard Discord Bot Personas](.github/assets/readme/discordbotpersonas.png)

## 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

- Documentation: [docs.kyber.chat](https://docs.kyber.chat)
- GitHub: [github.com/cyph3rasi/kyber](https://github.com/cyph3rasi/kyber/)
- Community: [discord.gg/HJCFXTz2bE](https://discord.gg/HJCFXTz2bE)
- Updates: [x.com/Kyber_chat](https://x.com/Kyber_chat)

## 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
