Metadata-Version: 2.4
Name: kyber-chat
Version: 2026.4.21.42
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, skills
- `Runs anywhere` Laptop, VPS, homelab, Raspberry Pi
- `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

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

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