learnharness README

README проекта с github.com/amosblomqvist/learnharness. Одним файлом markdown: README.md.

LearnHarness

An agent harness for learning.

Download · How it works · Documentation · Issues · Discord

LearnHarness uses AI agents to plan and teach lessons from your current understanding to your goal. It builds a detailed picture of what you understand and how you reason. That picture is updated as you learn.

Instead of just giving you an explanation, it uses your answers and thinking to decide what you need next. Teaching builds understanding one reasoning step at a time. Practice makes it usable. A persistent knowledge graph carries it across sessions.

LearnHarness teaching session

How it works

  1. Measure. Before teaching, the agent finds where your understanding ends on each part the lesson depends on. Your answers, confidence, and thinking show it where to start.
  2. Plan. It works out a dependency map from that starting point to your goal. You can see the plan, and the lesson adapts when your understanding turns out different.
  3. Teach. Each step builds on something you already understand. You predict, get an explanation, and check your understanding. Confusions are repaired before anything is built on them. The aim is for the goal to feel obviously true, not merely familiar.
  4. Practice. Separate sessions pose varied problems that require the right knowledge to come to mind without being named first. Problems and hints adapt to your reasoning.

Think out loud. The thinking fields let you explain your reasoning, uncertainties, and reactions in your own words. This is how the agent gets a detailed picture rather than just a record of right and wrong answers. You can type or use dictation.

Bring your files. In the desktop app, attach PDFs, photos, or any other file with the paperclip, or drag them in. The file stays where it is: the message carries its path, and the agent reads it from there.

The agent can also research questions in the background, create visual explanations, show your own images in the lesson and mark them up with arrows and labels, and build interactive demonstrations.

Knowledge that carries forward

What you are taught accumulates as propositions and reasoning chains: individual claims and the premises that lead to them. The graph shows this structure, with links back to the source sessions. You can also import notes.

Future teaching sessions can read the graph instead of starting from scratch. Practice sessions can draw their material from it. It stores the ideas and their connections, not ratings of your ability.

LearnHarness knowledge graph

Download and get started

Download from learnharness.ai · GitHub Releases

Choose your models, then start a session with what you want to understand. You can use provider API keys, supported subscription connections in the desktop app, an installed Claude Code CLI, or a custom OpenAI-compatible endpoint, including a local model server. Optional dictation and web search use separate service keys. Web research can use a Tavily, Brave, Exa, Firecrawl, or Ollama key in Settings → Providers → Search. Ollama search uses its hosted service, not a local model server.

See Getting started for model setup, dictation, files, and notes imports, and context, caching, and costs for advanced cache preferences.

All three platforms support in-app updates.

Your keys, your data

Development and support

npm ci
npm run plugins:setup
npm run dev        # http://localhost:3000
npm test           # fixtures and fake providers

See the documentation index for all guides, development for setup and checks, architecture for the runtime, keyboard shortcuts, themes for the theme file format, and desktop builds and releases.

For trusted local plugins, start with the authoring guide and capability map. It links the question, practice-problem, submission, view-context and UI contracts. Use examples/plugins/ for small runnable templates, plugins/ for feature source projects, and the host architecture for internals.

Questions, bug reports, and feature requests: GitHub Issues.

Security vulnerabilities: report privately as described in SECURITY.md, not in public issues.

License

AGPL-3.0

The app is free and open forever. If we ever charge for anything, it will be for convenience — managed keys, hosting — never for features you can run locally.

learnharness (amosblomqvist/learnharness)

Ищем в базе…

Что это такое?LearnHarness — настольное приложение, которое использует ИИ-агентов, чтобы помогать вам разбираться в сложных темах: оно определяет, что вы уже понимаете, строит путь к вашей цели, объясняет по одному шагу рассуждения и затем проверяет вас практическими задачами. Постоянный граф знаний переносит ваши знания между сессиями.
Это просто ещё один ИИ-чатбот?Нет, он работает по структурированному циклу из четырёх шагов: Оценка (выясняет, где заканчивается ваше понимание), План (строит карту зависимостей до вашей цели), Объяснение (пошаговые разъяснения с предсказанием и проверочными вопросами) и Практика (отдельные сессии с разнообразными задачами). Также можно вслух проговаривать ход своих рассуждений — печатью или диктовкой, — а не просто получать оценку «правильно» или «неправильно».
Как его запустить?Скачайте подписанный DMG для macOS, установщик для Windows или AppImage/.deb для Linux с learnharness.ai или со страницы GitHub Releases, затем добавьте API-ключ провайдера, выберите модели и начните сессию с той темы, которую хотите понять.
Нужен ли мне API-ключ от конкретного провайдера?Вы используете собственный ключ одного из 30+ поддерживаемых провайдеров, включая OpenAI, Anthropic, Google, DeepSeek и OpenRouter. Необязательные функции диктовки и веб-поиска требуют отдельных ключей сервисов.
Установщик для Windows уже готов к использованию?Он работает, но пока не подписан, поэтому при запуске Windows может показать предупреждение «неизвестный издатель» или SmartScreen.
Куда деваются мои данные об обучении и API-ключ?Ваши чаты, граф знаний, настройки и API-ключи хранятся локально на вашем компьютере в виде простых файлов, которые можно открыть и просмотреть, без подписки LearnHarness и без наценки. Запросы к моделям, веб-исследования и диктовка по-прежнему обращаются к настроенным вами внешним провайдерам.
Что на самом деле хранит граф знаний?Он хранит утверждения и цепочки рассуждений — отдельные тезисы и посылки, на которых они основаны, — со ссылками на сессии, из которых они взяты. Так будущие занятия по объяснению и практике могут опираться на уже изученное, а не начинаться с нуля.
Могу ли я говорить с ним вместо того, чтобы печатать?Да, диктовка поддерживается как необязательный способ ввода наравне с печатью; для неё нужен отдельный ключ сервиса.
Умеет ли он что-то помимо текстовых объяснений?Агент может в фоновом режиме исследовать вопросы и создавать наглядные объяснения и интерактивные демонстрации в рамках объяснения темы.
Какие есть похожие проекты?starnet, get-it, Orbital, holaOS, opensquilla, ohmygame, open-codesign, mixdog
Автор
amosblomqvist
Размер
12.8 MB
Звёзды
9.9K
Возраст
1 мес
Коммиты · 90 дней