bielik 0.1.1

Bielik — local Ollama chat client (CLI + web)

🦅 bielik

Author: Tom Sapletta
License: Apache-2.0

🇵🇱 Bielik to lokalny klient chat do Ollama z interfejsem CLI i web, stworzony specjalnie dla polskiego modelu językowego Bielik od Speakleash.

---

🏗️ Architecture

┌─────────────────────────────────────────────────────────────────┐
│                          🦅 BIELIK                             │
├─────────────────────┬───────────────────────┬───────────────────┤
│   🖥️  CLI Shell     │  🌐 FastAPI Server   │  🧪 Test Suite   │
│  ┌─────────────────┐│ ┌───────────────────┐ │ ┌───────────────┐ │
│  │ • Interactive   ││ │ • REST /chat      │ │ │ • Unit tests  │ │
│  │ • Help system   ││ │ • WebSocket /ws   │ │ │ • Mock API    │ │
│  │ • Cross-platform││ │ • Port 8888       │ │ │ • CI/CD       │ │
│  └─────────────────┘│ └───────────────────┘ │ └───────────────┘ │
└─────────────────────┴───────────────────────┴───────────────────┘
            │                       │                       │
            ▼                       ▼                       ▼
┌─────────────────────────────────────────────────────────────────┐
│                    🔄 CONNECTION LAYER                         │
│  ┌──────────────────────┐    ┌─────────────────────────────┐   │
│  │    REST API (main)   │◄──►│   Ollama Library (fallback) │   │
│  │ ┌─ HTTP requests     │    │ ┌─ ollama.chat()           │   │
│  │ └─ /v1/chat/...     │    │ └─ Direct integration      │   │
│  └──────────────────────┘    └─────────────────────────────────┘   │
└─────────────────────┬───────────────────────────────────────────┘
                      ▼
┌─────────────────────────────────────────────────────────────────┐
│                   🦙 OLLAMA SERVER                              │
│  ┌─────────────────────────────────────────────────────────────┤
│  │ 📍 localhost:11434 (default)                              │
│  │ 🤖 Model: bielik (Polish LLM)                             │
│  │ 🔗 Links: Speakleash → HuggingFace → Ollama               │
│  └─────────────────────────────────────────────────────────────┤
└─────────────────────────────────────────────────────────────────┘

---

🤖 About Bielik Model

Bielik to przełomowy polski model językowy stworzony przez Speakleash - fundację zajmującą się rozwojem polskiej sztucznej inteligencji.

🔗 External Dependencies & Links:

• Ollama - Local LLM runtime that hosts the Bielik model
• Bielik Model on HuggingFace - Official model repository
• Speakleash Foundation - Creators of the Bielik model
• Polish AI Initiative - Government support for Polish AI

🚀 How it Works:

1. Bielik package connects to your local Ollama server
2. Ollama runs the Bielik model (downloaded from HuggingFace via Speakleash)
3. Chat interface (CLI/Web) sends queries → Ollama API → Bielik model → responses
4. Fallback system ensures connectivity (REST API → ollama library)

---

📌 Features

• 🖥️ CLI bielik — interactive chat shell with smart fallback system
• 🌐 Web server (FastAPI on port 8888):
  • POST /chat — RESTful chat endpoint
  • WS /ws — real-time WebSocket chat
• 🔄 Dual connectivity — REST API primary, ollama lib fallback
• 🧪 Full test coverage — unit tests with mocked APIs
• 🔧 Developer tools — Makefile automation, CI/CD ready

---

⚙️ Installation

pip install bielik

Optional dependency (official Ollama lib):

pip install "bielik[ollama]"

---

🚀 Usage

CLI

bielik

Wpisz wiadomości, zakończ :exit.

Web API

uvicorn bielik.server:app --port 8888

• POST /chat:

{"messages": [{"role":"user","content":"Hello!"}]}

• WebSocket /ws

---

🔧 Environment Variables

• OLLAMA_HOST — default: http://localhost:11434
• BIELIK_MODEL — default: bielik

---

📝 Development

git clone https://github.com/tomsapletta/bielik.git
cd bielik
python -m venv .venv
source .venv/bin/activate
pip install -e .[ollama]

📂 Struktura

bielik/
├── bielik/
│   ├── __init__.py
│   ├── cli.py
│   └── server.py
├── tests/
│   ├── __init__.py
│   ├── test_cli.py
│   └── test_server.py
├── pyproject.toml
├── setup.cfg
├── MANIFEST.in
├── LICENSE
├── README.md
├── Makefile
└── .github/workflows/python-publish.yml

📜 License

Apache License 2.0