bielik 0.1.0

Bielik — local Ollama chat client (CLI + web)

🦅 bielik

Author: Tom Sapletta
License: Apache-2.0

---

📌 Features

• CLI bielik — interactive chat shell with Ollama (REST → fallback ollama lib).
• Web server (FastAPI on port 8888):
  • POST /chat — send chat messages
  • WS /ws — websocket chat

---

⚙️ 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