Skip to content

Repository files navigation

TokenSmith icon

TokenSmith

TokenSmith helps students learn from their course materials using local language models running on their laptop.

  • Add your textbooks, lecture notes, and papers.
  • Work through difficult concepts with explanations and examples.
  • Explore suggested questions.
  • Test your understanding with short quizzes and feedback.

Local models run through Ollama. You can also connect a cloud model with an API key.

Download | Watch the demo | Get started

Download

Latest release | Release notes for v0.1.14

Platform Download v0.1.14
macOS (Apple Silicon) DMG
Windows (x64) Portable ZIP
Linux (x64) AppImage or Debian package

Demo

tokensmith-demo.mp4

Get Started

  1. Install and start Ollama, then use TokenSmith's setup guide to download a local embedding model for searching your documents.
  2. Choose a local chat model, or select Connect a cloud chat model and use your own API key.
  3. Add your course materials in Library. PDF, Markdown, and text files are supported.
  4. Start with your own question or a suggested one. Open the source passages, follow up on an explanation, or choose Quiz me to practice.

Project Health

CI Accuracy benchmark (retrieval) Frontend TypeScript coverage Backend Python coverage

The benchmark checks whether search retrieves the expected evidence.

See testing and benchmarks for what the checks measure and how to run them.

Contributing

Report a problem or see the development guide to run, build, and package the app.

About

Hand-crafting answers with more precision

Resources

Stars

14 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages