Metadata-Version: 2.4
Name: bielik
Version: 0.2.9
Summary: Bielik — Local-first AI assistant with HuggingFace and SpeakLeash models
Author: Tom Sapletta
License-Expression: Apache-2.0
Keywords: llm,chat,huggingface,bielik,polish,ai,assistant
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Natural Language :: Polish
Classifier: Natural Language :: English
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer<1.0.0,>=0.9.0
Requires-Dist: rich<14.0.0,>=13.0.0
Requires-Dist: python-dotenv<2.0.0,>=1.0.0
Requires-Dist: pypdf<4.0.0,>=3.0.0
Requires-Dist: python-docx<1.0.0,>=0.8.11
Requires-Dist: beautifulsoup4<5.0.0,>=4.8.0
Requires-Dist: html2text<2025.0.0,>=2020.1.16
Requires-Dist: huggingface-hub<1.0.0,>=0.16.0
Requires-Dist: tokenizers<1.0.0,>=0.13.0
Requires-Dist: sentencepiece<1.0.0,>=0.1.99
Requires-Dist: protobuf<5.0.0,>=4.21.0
Provides-Extra: local
Requires-Dist: llama-cpp-python<1.0.0,>=0.2.0; extra == "local"
Requires-Dist: sentence-transformers<3.0.0,>=2.2.0; extra == "local"
Provides-Extra: gpu
Requires-Dist: bielik[local]; extra == "gpu"
Requires-Dist: torch<3.0.0,>=2.0.0; extra == "gpu"
Requires-Dist: transformers<5.0.0,>=4.30.0; extra == "gpu"
Requires-Dist: accelerate<1.0.0,>=0.20.0; extra == "gpu"
Requires-Dist: bitsandbytes<1.0.0,>=0.40.0; extra == "gpu"
Provides-Extra: ai
Requires-Dist: bielik[gpu]; extra == "ai"
Requires-Dist: transformers[torch]<5.0.0,>=4.30.0; extra == "ai"
Requires-Dist: datasets<3.0.0,>=2.12.0; extra == "ai"
Requires-Dist: evaluate<1.0.0,>=0.4.0; extra == "ai"
Provides-Extra: dev
Requires-Dist: bielik[ai]; extra == "dev"
Requires-Dist: pytest<8.0.0,>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov<5.0.0,>=4.0.0; extra == "dev"
Requires-Dist: flake8<7.0.0,>=6.0.0; extra == "dev"
Requires-Dist: black<24.0.0,>=23.0.0; extra == "dev"
Requires-Dist: isort<6.0.0,>=5.12.0; extra == "dev"
Requires-Dist: mypy<2.0.0,>=1.0.0; extra == "dev"
Requires-Dist: build<1.0.0,>=0.10.0; extra == "dev"
Requires-Dist: twine<5.0.0,>=4.0.0; extra == "dev"
Requires-Dist: pre-commit<4.0.0,>=3.0.0; extra == "dev"
Provides-Extra: docs
Requires-Dist: mkdocs<2.0.0,>=1.4.0; extra == "docs"
Requires-Dist: mkdocs-material<10.0.0,>=9.0.0; extra == "docs"
Requires-Dist: mkdocstrings[python]<1.0.0,>=0.20.0; extra == "docs"
Provides-Extra: test
Requires-Dist: pytest<8.0.0,>=7.0.0; extra == "test"
Requires-Dist: pytest-cov<5.0.0,>=4.0.0; extra == "test"
Requires-Dist: pytest-mock<4.0.0,>=3.10.0; extra == "test"
Requires-Dist: pytest-asyncio<1.0.0,>=0.20.0; extra == "test"
Provides-Extra: completion
Requires-Dist: click-completion<1.0.0,>=0.5.0; extra == "completion"
Requires-Dist: shellingham<2.0.0,>=1.5.0; extra == "completion"
Provides-Extra: web
Requires-Dist: fastapi<1.0.0,>=0.95.0; extra == "web"
Requires-Dist: uvicorn[standard]<1.0.0,>=0.21.0; extra == "web"
Requires-Dist: jinja2<4.0.0,>=3.0.0; extra == "web"
Requires-Dist: python-multipart<1.0.0,>=0.0.6; extra == "web"
Provides-Extra: all
Requires-Dist: bielik[ai,completion,dev,docs,test,web]; extra == "all"
Dynamic: license-file

# 🦅 Bielik

**Polish AI Assistant CLI** - Advanced command-line interface for local HuggingFace model execution with Context Provider Commands.

**Bielik** is a groundbreaking Polish language model created by **[Speakleash](https://speakleash.org/)** - a foundation dedicated to the development of Polish artificial intelligence.

> 🇵🇱 **Bielik models** are available on **[HuggingFace Hub](https://huggingface.co/speakleash)**

[![Build](https://img.shields.io/github/actions/workflow/status/tom-sapletta-com/bielik/python-app.yml?branch=main)](https://github.com/tom-sapletta-com/bielik/actions)
[![PyPI](https://img.shields.io/pypi/v/bielik.svg)](https://pypi.org/project/bielik/)
[![Downloads](https://img.shields.io/pypi/dm/bielik)](https://pypi.org/project/bielik/)
[![Python](https://img.shields.io/pypi/pyversions/bielik.svg)](https://www.python.org/)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
[![Stars](https://img.shields.io/github/stars/tom-sapletta-com/bielik?style=social)](https://github.com/tom-sapletta-com/bielik)
[![Docker](https://img.shields.io/badge/Docker-Ready-blue?logo=docker)](docs/DOCKER.md)
[![Conda](https://img.shields.io/badge/Conda%20Env-ready-green?logo=anaconda)](docs/INSTALLATION.md)
[![HuggingFace](https://img.shields.io/badge/HuggingFace-SpeakLeash-orange?logo=huggingface)](https://huggingface.co/speakleash)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](docs/CONTRIBUTING.md)

---

## 🚀 **Quick Start**

### **One-liner Installation**
```bash
curl -sSL https://raw.githubusercontent.com/tom-sapletta-com/bielik/main/quick-install.sh | bash
```

### **Basic Usage**
```bash
# Interactive mode
bielik

# Single prompt
bielik -p "Jak się masz?"

# Context Provider Commands (instant execution)
bielik -p "calc: 2 + 3 * 4"
bielik -p "folder: ."
```

---

## ✨ **Key Features**

- **🎯 Local Execution** - Complete privacy, no external API calls  
- **💬 Polish Language Optimized** - Built for Polish conversation and analysis
- **⚡ Context Provider Commands** - Instant data processing without AI model loading
- **🖼️ Vision Capabilities** - Image analysis and visual question answering
- **📁 Document Processing** - PDF, DOCX, web content analysis
- **🐳 Docker Ready** - Comprehensive multiplatform testing
- **🔧 Extensible** - Easy custom command development

---

## 📚 **Complete Documentation**

**📖 For detailed information, visit our comprehensive documentation:**

### **📋 Core Documentation**
- **[📖 Documentation Home](docs/README.md)** - Navigation and overview
- **[📥 Installation Guide](docs/INSTALLATION.md)** - Conda, manual, Docker, troubleshooting
- **[🏗️ System Architecture](docs/ARCHITECTURE.md)** - Design, components, data flow
- **[⚡ Usage Guide](docs/USAGE.md)** - Commands, examples, best practices

### **🛠️ Development**  
- **[🤝 Contributing Guide](docs/CONTRIBUTING.md)** - Development setup, standards, PR process
- **[🔌 Python API](docs/API.md)** - Client usage, WebSocket, error handling
- **[🎯 Context Provider Commands](docs/CONTEXT_PROVIDERS.md)** - Custom command development
- **[🐳 Docker Testing](docs/DOCKER.md)** - Multiplatform testing framework

---

## 🤝 **Contributing**

We welcome contributions! See our **[Contributing Guide](docs/CONTRIBUTING.md)** for:
- Development setup and standards
- Pull request process  
- Code quality guidelines
- Testing requirements

---

## 📄 **License**

This project is licensed under the **Apache License 2.0** - see the [LICENSE](LICENSE) file for details.

---

**Author:** Tom Sapletta  
**🏢 Founder & CEO at [Telemonit](https://www.telemonit.com)** - Edge computing power solutions  
**🌍 Based in Germany | Open to collaboration**




  
