🚀 Advanced AI Assistant - Умный AI-помощник с красивым интерфейсом, встроенным Groq AI, системой плагинов
🤖 Умный AI-ассистент с встроенным бесплатным Groq AI
🌙 Красивый темно-фиолетовый интерфейс с анимациями
🔌 Расширяемая система плагинов
⚡ Быстрая установка • 📖 Использование • 🔌 Плагины • 🛠️ Разработка
Klp3 — это продвинутый AI-ассистент для командной строки, который работает "из коробки" без необходимости настройки API ключей. Встроенный бесплатный Groq AI (Mixtral 8x7B) обеспечивает быстрые и качественные ответы.
# Глобальная установка
npm install -g klp3-code
# Запуск
klp3
Klp3 автоматически установит необходимые Python зависимости при первом запуске.
klp3
При первом запуске Klp3:
~/.klp3/| Команда | Описание |
|---|---|
/help | Показать справку |
/stats | Статистика использования |
/plugins | Управление плагинами |
/clear | Очистить экран |
/reset | Очистить историю чата |
/update | Проверить обновления |
/exit | Выйти из приложения |
💬 Вы: Расскажи о квантовых компьютерах
🤖 Klp3 AI: Квантовые компьютеры — это вычислительные устройства...
💬 Вы: Создай Python функцию для сортировки списка
🤖 Klp3 AI:
```python
def sort_list(data, reverse=False):
"""
Сортировка списка
Args:
data: Список для сортировки
reverse: Обратная сортировка (по умолчанию False)
Returns:
list: Отсортированный список
"""
return sorted(data, reverse=reverse)
# Пример использования
numbers = [3, 1, 4, 1, 5, 9, 2, 6]
sorted_numbers = sort_list(numbers)
print(sorted_numbers) # [1, 1, 2, 3, 4, 5, 6, 9]
#### 🔌 Использование плагинов
💬 Вы: /ls
🔌 FileManager: 📁 Содержимое текущей папки:
📁 documents
📁 downloads
📄 readme.txt (1.2 KB)
💬 Вы: /system 🔌 SystemInfo: 🖥️ Система: Windows 11 🏗️ Архитектура: AMD64 💻 Процессор: Intel Core i7 🐍 Python: 3.11.5
---
## 🔌 Плагины
Klp3 поставляется с встроенными плагинами и поддерживает пользовательские расширения.
### Встроенные плагины
#### 📁 FileManager
- `/ls [path]` - Список файлов и папок
- `/cat <file>` - Просмотр содержимого файла
- `/mkdir <dir>` - Создание папки
- `/pwd` - Текущая папка
#### 🖥️ SystemInfo
- `/system` - Информация о системе
- `/memory` - Использование памяти
- `/disk` - Использование диска
- `/python` - Информация о Python
### Управление плагинами
```bash
# Список всех плагинов
/plugins list
# Включить плагин
/plugins enable FileManager
# Выключить плагин
/plugins disable SystemInfo
# Перезагрузить плагины
/plugins reload
Скопируйте шаблон:
cp ~/.klp3/templates/plugin_template.py ~/.klp3/plugins/my_plugin.py
Отредактируйте плагин:
class MyPlugin(BasePlugin):
def get_name(self) -> str:
return "MyPlugin"
def can_handle(self, command: str) -> bool:
return command.startswith("/my_command")
async def handle_command(self, command: str, context=None):
return {"success": True, "result": "Привет из плагина!"}
plugin = MyPlugin()
Перезагрузите плагины:
/plugins reload
/plugins enable MyPlugin
Klp3 создает папки в домашней директории:
~/.klp3/ # Главная папка
├── plugins/ # Пользовательские плагины
│ ├── plugin_template.py # Шаблон для создания плагинов
│ └── my_plugin.py # Ваши плагины
├── data/ # Сессии и данные
├── cache/ # Кэш системы
└── config.json # Пользовательские настройки
from core.plugins import BasePlugin
class MyPlugin(BasePlugin):
def get_name(self) -> str:
return "MyPlugin"
def get_description(self) -> str:
return "Описание плагина"
def get_version(self) -> str:
return "1.0.0"
def get_commands(self) -> List[str]:
return ["/my_command - Описание команды"]
async def initialize(self) -> bool:
# Инициализация плагина
return True
async def cleanup(self):
# Очистка ресурсов
pass
def can_handle(self, command: str) -> bool:
return command.startswith("/my_command")
async def handle_command(self, command: str, context=None):
return {
"success": True,
"result": "Результат выполнения команды"
}
# Обязательно: экспорт плагина
plugin = MyPlugin()
Метод handle_command() должен возвращать словарь:
# Успешное выполнение
{
"success": True,
"result": "Текст для показа пользователю"
}
# Ошибка
{
"success": False,
"error": "Описание ошибки"
}
Параметр context может содержать:
user_input - исходный ввод пользователяsession - информация о сессииeval()get_commands()Файл ~/.klp3/config.json:
{
"ui": {
"animations": true,
"typing_effect": true,
"auto_save_sessions": true
},
"system": {
"check_updates": true,
"max_history": 50,
"auto_load_plugins": true
},
"plugins": {
"auto_install_examples": true,
"safety_check": true,
"max_plugins": 10
}
}
Klp3 не требует настройки переменных окружения - все работает "из коробки".
Klp3 автоматически проверяет обновления при запуске (не чаще раза в день).
# В приложении
/update
# Или через npm
npm update -g klp3-code
Klp3 отслеживает использование и показывает статистику:
📊 Статистика использования
┌─────────────────────┬──────────────────┐
│ Метрика │ Значение │
├─────────────────────┼──────────────────┤
│ 🤖 AI Модель │ mixtral-8x7b-32768│
│ 🆓 Провайдер │ Groq (Free) │
│ 📊 Токены (сессия) │ 1,247 │
│ 📈 Токены (всего) │ 5,892 │
│ 🔄 Запросов │ 23 │
│ 💬 Сообщений │ 46 │
│ ⏱️ Время сессии │ 15м 32с │
└─────────────────────┴──────────────────┘
Нет! Klp3 использует встроенный бесплатный Groq AI. Никакой регистрации или ключей не требуется.
Klp3 требует интернет-соединения для запросов к AI, но система плагинов и интерфейс работают локально.
Да! Klp3 не отправляет личные данные. История разговоров хранится только локально в ~/.klp3/data/.
В текущей версии встроен только Groq AI для простоты использования. Поддержка других провайдеров планируется в будущих версиях.
# Удалить приложение
npm uninstall -g klp3-code
# Удалить данные (опционально)
rm -rf ~/.klp3
Нашли ошибку? Создайте issue на GitHub:
klp3 --version)~/.klp3/cache/Мы приветствуем вклад в развитие Klp3!
# Клонировать репозиторий
git clone https://github.com/kilopa-ai/klp3-code.git
cd klp3-code
# Установить зависимости
pip install -r requirements.txt
# Запустить в режиме разработки
python main.py
MIT License. Смотрите LICENSE для подробностей.
Создано с ❤️ командой KilopaAI
🌟 GitHub • 📦 NPM • 💬 Поддержка
FAQs
🚀 Advanced AI Assistant - Умный AI-помощник с красивым интерфейсом, встроенным Groq AI, системой плагинов
We found that klp3-code demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Multiple high-impact npm maintainers confirm they have been targeted in the same social engineering campaign that compromised Axios.
Security News
Axios compromise traced to social engineering, showing how attacks on maintainers can bypass controls and expose the broader software supply chain.
Security News
Node.js has paused its bug bounty program after funding ended, removing payouts for vulnerability reports but keeping its security process unchanged.