Metadata-Version: 2.4
Name: fedoshelpos
Version: 0.3.0
Summary: Chat with any LLM + offline olympiad task helper. Zero dependencies.
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# fedoshelpos 0.3.0

Библиотека Python для тренировки и разбора олимпиадных задач + offline AI helper.
Зависимостей нет, только стандартная библиотека, Python 3.9+.

**Работает без интернета** в двух вариантах:

1. Локальная модель на твоём компьютере (Ollama, LM Studio, llama.cpp) — обращение только на localhost.
2. Совсем без ИИ: встроенные шаблоны алгоритмов, краткая теория, локальный тестер.

Если есть интернет — можно подключить любой OpenAI-совместимый адрес (свои base_url и api_key).

## Быстрый старт без установки

```
python run.py --offline
```

## Как библиотека

```python
import fedoshelpos as f

print(f.topics())                 # список тем
print(f.template("dijkstra"))     # готовый шаблон

ai = f.AI.no_ai()                 # вообще без сети
code = ai.solve(open("examples/task.txt", encoding="utf-8").read(),
                tests="examples/tests", save_to="solution.py")

ai = f.AI.ollama("qwen2.5-coder:7b")   # локальная модель
print(ai.chat("Как считать LCA бинарным подъёмом?"))
```

## Файлы

- `run.py` — запуск без установки
- `fedoshelpos/config.py` — настройки и профили (`~/.fedoshelpos.json`)
- `fedoshelpos/core.py` — клиент, решатель, тестер
- `fedoshelpos/offline.py` — офлайн-ядро: распознавание темы, теория, шаблоны
- `fedoshelpos/templates/` — 17 шаблонов алгоритмов
- `INSTRUCTION.md` — пошаговая инструкция

## Важно

На реальных олимпиадах ИИ и интернет запрещены. Это инструмент для тренировки дома и разбора задач после тура.
