abhyasa 0.0.1__tar.gz

abhyasa-0.0.1/.gitignore

@@ -0,0 +1,158 @@
+_docs/
+_proc/
+
+*.bak
+.gitattributes
+.last_checked
+.gitconfig
+*.bak
+*.log
+*~
+~*
+_tmp*
+tmp*
+tags
+*.pkg
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+conda/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# dotenv
+.env
+
+# virtualenv
+.venv
+venv/
+ENV/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+
+.vscode
+*.swp
+
+# osx generated files
+.DS_Store
+.DS_Store?
+.Trashes
+ehthumbs.db
+Thumbs.db
+.idea
+
+# pytest
+.pytest_cache
+
+# tools/trust-doc-nbs
+docs_src/.last_checked
+
+# symlinks to fastai
+docs_src/fastai
+tools/fastai
+
+# link checker
+checklink/cookies.txt
+
+# .gitconfig is now autogenerated
+.gitconfig
+
+# Quarto installer
+.deb
+.pkg
+
+# Quarto
+.quarto
+
+.venv/
+.kosha/
+_docs/
+_proc/
+nbs/_fixtures/

abhyasa-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Karthik
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

abhyasa-0.0.1/PKG-INFO

@@ -0,0 +1,158 @@
+Metadata-Version: 2.5
+Name: abhyasa
+Version: 0.0.1
+Summary: A learning harness that makes you think: active recall, a learner model and a concept graph in your vault
+Project-URL: Repository, https://github.com/vedicreader/abhyasa
+Project-URL: Documentation, https://vedicreader.github.io/abhyasa/
+Author-email: Karthik <karthik.rajgopal@hotmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: active-recall,learning,nbdev,spaced-repetition,vishalakshi
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Education
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.12
+Requires-Dist: fastcore>=1.8
+Requires-Dist: ipywidgets>=8.1
+Requires-Dist: python-fasthtml>=0.14
+Requires-Dist: rishi>=0.1.56
+Requires-Dist: vishalakshi>=0.1.35
+Provides-Extra: dev
+Requires-Dist: ipykernel>=7.3.0; extra == 'dev'
+Requires-Dist: nbdev>=3.3.25; extra == 'dev'
+Requires-Dist: notebook>=7.6.3; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Provides-Extra: whisper
+Requires-Dist: mlx-audio>=0.5; extra == 'whisper'
+Description-Content-Type: text/markdown
+
+# abhyasa
+
+
+<!-- WARNING: THIS FILE WAS AUTOGENERATED! DO NOT EDIT! -->
+
+abhyasa (अभ्यास) means steady practice. It is a tutor that asks you questions and makes you do the thinking.
+It never gives the answer first. You answer in text or by voice, and you can think aloud.
+The tutor grades your reasoning, not only the result.
+A learner model keeps the depth of each concept that you know, and the date of its next review.
+
+## How it works
+
+Each question goes through one loop:
+
+1.  Pick. Code chooses the next concept and the depth: a due review first, then the frontier. The app shows the reason.
+2.  Ask. A model writes one question at that depth, with a hidden model answer and a rubric.
+3.  Struggle. You answer. A wrong try gets the first error and a nudge, but no fix. You can ask for hints, one rung at a time.
+4.  Grade. The model grades the answer and the think-aloud. Code grades choice questions and code exercises.
+5.  Update. Correctness and confidence move the floor, the ceiling and the next review date of the concept.
+6.  Teach. After a miss, the tutor teaches the smallest step that fixes the first error. Then it asks a check question.
+
+| term    | meaning                                                           |
+|---------|-------------------------------------------------------------------|
+| concept | one idea that you can be asked about                              |
+| depth   | 0 unseen, 1 recognise, 2 recall, 3 explain, 4 apply, 5 transfer   |
+| floor   | the highest depth that you pass reliably                          |
+| ceiling | the lowest depth that you failed                                  |
+| attempt | one answer, kept as a vault document                              |
+| session | one sitting of questions, with a summary                          |
+| hint    | one rung of a ladder of six, from the least to the most revealing |
+| lesson  | the smallest step that the tutor teaches after a miss             |
+
+## Install and run
+
+Install the package and its dependencies:
+
+``` sh
+uv sync
+```
+
+Start the web app on <http://127.0.0.1:5077>:
+
+``` sh
+uv run abhyasa
+```
+
+The app listens on the loopback address only. These variables change the defaults:
+
+| variable | what it sets | default |
+|----|----|----|
+| `ABHYASA_VAULT` | the vault file | the vault of vishalakshi |
+| `ABHYASA_MODEL` | the rishi model for questions, grades, hints and lessons | `claude/sonnet` |
+| `ABHYASA_STT` | the speech-to-text engine: `gemma` or `whisper` | `gemma` |
+
+## Surfaces
+
+All surfaces use the same tutor and the same data.
+
+### Web app
+
+The web app is made from blocks under `abhyasa/blocks`:
+
+| block | what it does |
+|----|----|
+| `today` | the home page: what is due and what to do now |
+| `session` | one sitting with the tutor: one question at a time, with hints, confidence and “I don’t know” |
+| `voice` | a mic button for each text box; it turns speech into text on this machine |
+| `concepts` | the list of concepts, and one page for each concept with its state |
+| `graph` | the concept graph: a color for each floor, a ring when a review is due, arrows for prereqs |
+| `search` | one search over the `learning` shelf and the other shelves of your vault |
+| `add` | add concepts from a text, a vault document or vedicreader |
+
+### ramabana
+
+The `/learn` extension gives the tutor in the terminal, beside your code.
+To turn it on, make the file `~/.config/ramabana/extensions/abhyasa.py` with this line:
+
+``` python
+from abhyasa.rama import setup
+```
+
+### Notebooks
+
+In leela or Jupyter, [`learn`](https://vedicreader.github.io/abhyasa/nb.html#learn) shows a question card. [`exercise`](https://vedicreader.github.io/abhyasa/nb.html#exercise) gives a code exercise that its tests check in the kernel.
+
+``` python
+from abhyasa.nb import learn, exercise
+learn('reciprocal-rank-fusion')
+ex = exercise('reciprocal-rank-fusion')
+```
+
+## Where the data is
+
+All data is on the `learning` shelf of the vishalakshi vault.
+Each concept, attempt and session is one vault document, so other tools can search it.
+Tests use a vault in a temporary folder and never open your real vault.
+
+## Example
+
+This example runs offline. [`temp_learning`](https://vedicreader.github.io/abhyasa/store.html#temp_learning) makes a shelf in a temporary vault, and [`Fake`](https://vedicreader.github.io/abhyasa/llm.html#fake) replaces the model.
+
+``` python
+from abhyasa.store import temp_learning
+from abhyasa.llm import Fake
+from abhyasa.tutor import Tutor
+
+lr = temp_learning()
+lr.put('Ranking', 'Order items by a score.', 'ml')
+fake = Fake({'You grade one answer': dict(correct=True, grade=8, first_error='', misconception='', feedback='Yes. Only the order counts.')},
+            dflt=dict(question='Why can you compare ranks from two systems, but not their scores?', answer='Ranks share one scale.', rubric=['ranks share one scale']))
+t = Tutor(lr, fake, context=False)
+```
+
+Ask the first question. `why` gives the reason for the choice. A new concept starts at depth 3 (explain).
+
+``` python
+q = t.next()
+assert q.why == 'next on the frontier: its prereqs are in place'
+assert q.depth == 3
+print(q.question)
+```
+
+Answer with high confidence. A `solid` pass at depth 3 raises the floor to 3.
+
+``` python
+r = t.answer(q.id, 'A rank is a position, and positions use the same scale in each list.', confidence=80)
+assert r.outcome == 'solid'
+assert lr.concept('ranking').floor == 3
+```

abhyasa-0.0.1/README.md

@@ -0,0 +1,129 @@
+# abhyasa
+
+
+<!-- WARNING: THIS FILE WAS AUTOGENERATED! DO NOT EDIT! -->
+
+abhyasa (अभ्यास) means steady practice. It is a tutor that asks you questions and makes you do the thinking.
+It never gives the answer first. You answer in text or by voice, and you can think aloud.
+The tutor grades your reasoning, not only the result.
+A learner model keeps the depth of each concept that you know, and the date of its next review.
+
+## How it works
+
+Each question goes through one loop:
+
+1.  Pick. Code chooses the next concept and the depth: a due review first, then the frontier. The app shows the reason.
+2.  Ask. A model writes one question at that depth, with a hidden model answer and a rubric.
+3.  Struggle. You answer. A wrong try gets the first error and a nudge, but no fix. You can ask for hints, one rung at a time.
+4.  Grade. The model grades the answer and the think-aloud. Code grades choice questions and code exercises.
+5.  Update. Correctness and confidence move the floor, the ceiling and the next review date of the concept.
+6.  Teach. After a miss, the tutor teaches the smallest step that fixes the first error. Then it asks a check question.
+
+| term    | meaning                                                           |
+|---------|-------------------------------------------------------------------|
+| concept | one idea that you can be asked about                              |
+| depth   | 0 unseen, 1 recognise, 2 recall, 3 explain, 4 apply, 5 transfer   |
+| floor   | the highest depth that you pass reliably                          |
+| ceiling | the lowest depth that you failed                                  |
+| attempt | one answer, kept as a vault document                              |
+| session | one sitting of questions, with a summary                          |
+| hint    | one rung of a ladder of six, from the least to the most revealing |
+| lesson  | the smallest step that the tutor teaches after a miss             |
+
+## Install and run
+
+Install the package and its dependencies:
+
+``` sh
+uv sync
+```
+
+Start the web app on <http://127.0.0.1:5077>:
+
+``` sh
+uv run abhyasa
+```
+
+The app listens on the loopback address only. These variables change the defaults:
+
+| variable | what it sets | default |
+|----|----|----|
+| `ABHYASA_VAULT` | the vault file | the vault of vishalakshi |
+| `ABHYASA_MODEL` | the rishi model for questions, grades, hints and lessons | `claude/sonnet` |
+| `ABHYASA_STT` | the speech-to-text engine: `gemma` or `whisper` | `gemma` |
+
+## Surfaces
+
+All surfaces use the same tutor and the same data.
+
+### Web app
+
+The web app is made from blocks under `abhyasa/blocks`:
+
+| block | what it does |
+|----|----|
+| `today` | the home page: what is due and what to do now |
+| `session` | one sitting with the tutor: one question at a time, with hints, confidence and “I don’t know” |
+| `voice` | a mic button for each text box; it turns speech into text on this machine |
+| `concepts` | the list of concepts, and one page for each concept with its state |
+| `graph` | the concept graph: a color for each floor, a ring when a review is due, arrows for prereqs |
+| `search` | one search over the `learning` shelf and the other shelves of your vault |
+| `add` | add concepts from a text, a vault document or vedicreader |
+
+### ramabana
+
+The `/learn` extension gives the tutor in the terminal, beside your code.
+To turn it on, make the file `~/.config/ramabana/extensions/abhyasa.py` with this line:
+
+``` python
+from abhyasa.rama import setup
+```
+
+### Notebooks
+
+In leela or Jupyter, [`learn`](https://vedicreader.github.io/abhyasa/nb.html#learn) shows a question card. [`exercise`](https://vedicreader.github.io/abhyasa/nb.html#exercise) gives a code exercise that its tests check in the kernel.
+
+``` python
+from abhyasa.nb import learn, exercise
+learn('reciprocal-rank-fusion')
+ex = exercise('reciprocal-rank-fusion')
+```
+
+## Where the data is
+
+All data is on the `learning` shelf of the vishalakshi vault.
+Each concept, attempt and session is one vault document, so other tools can search it.
+Tests use a vault in a temporary folder and never open your real vault.
+
+## Example
+
+This example runs offline. [`temp_learning`](https://vedicreader.github.io/abhyasa/store.html#temp_learning) makes a shelf in a temporary vault, and [`Fake`](https://vedicreader.github.io/abhyasa/llm.html#fake) replaces the model.
+
+``` python
+from abhyasa.store import temp_learning
+from abhyasa.llm import Fake
+from abhyasa.tutor import Tutor
+
+lr = temp_learning()
+lr.put('Ranking', 'Order items by a score.', 'ml')
+fake = Fake({'You grade one answer': dict(correct=True, grade=8, first_error='', misconception='', feedback='Yes. Only the order counts.')},
+            dflt=dict(question='Why can you compare ranks from two systems, but not their scores?', answer='Ranks share one scale.', rubric=['ranks share one scale']))
+t = Tutor(lr, fake, context=False)
+```
+
+Ask the first question. `why` gives the reason for the choice. A new concept starts at depth 3 (explain).
+
+``` python
+q = t.next()
+assert q.why == 'next on the frontier: its prereqs are in place'
+assert q.depth == 3
+print(q.question)
+```
+
+Answer with high confidence. A `solid` pass at depth 3 raises the floor to 3.
+
+``` python
+r = t.answer(q.id, 'A rank is a position, and positions use the same scale in each list.', confidence=80)
+assert r.outcome == 'solid'
+assert lr.concept('ranking').floor == 3
+```

abhyasa-0.0.1/abhyasa/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.0.1"

abhyasa-0.0.1/abhyasa/_modidx.py

@@ -0,0 +1,148 @@
+# Autogenerated by nbdev
+
+d = { 'settings': { 'branch': 'main',
+                'doc_baseurl': '/abhyasa',
+                'doc_host': 'https://vedicreader.github.io',
+                'git_url': 'https://github.com/vedicreader/abhyasa',
+                'lib_path': 'abhyasa'},
+  'syms': { 'abhyasa.ground': { 'abhyasa.ground.Learning.connect': ('ground.html#learning.connect', 'abhyasa/ground.py'),
+                                'abhyasa.ground.Learning.stale_links': ('ground.html#learning.stale_links', 'abhyasa/ground.py'),
+                                'abhyasa.ground.VaultSource': ('ground.html#vaultsource', 'abhyasa/ground.py'),
+                                'abhyasa.ground.VaultSource.__init__': ('ground.html#vaultsource.__init__', 'abhyasa/ground.py'),
+                                'abhyasa.ground.VaultSource._doc': ('ground.html#vaultsource._doc', 'abhyasa/ground.py'),
+                                'abhyasa.ground.VaultSource.search': ('ground.html#vaultsource.search', 'abhyasa/ground.py'),
+                                'abhyasa.ground.VedicSource': ('ground.html#vedicsource', 'abhyasa/ground.py'),
+                                'abhyasa.ground.VedicSource.__init__': ('ground.html#vedicsource.__init__', 'abhyasa/ground.py'),
+                                'abhyasa.ground.VedicSource.dbs': ('ground.html#vedicsource.dbs', 'abhyasa/ground.py'),
+                                'abhyasa.ground.VedicSource.search': ('ground.html#vedicsource.search', 'abhyasa/ground.py'),
+                                'abhyasa.ground._clean': ('ground.html#_clean', 'abhyasa/ground.py'),
+                                'abhyasa.ground.cite': ('ground.html#cite', 'abhyasa/ground.py'),
+                                'abhyasa.ground.find_notebooks': ('ground.html#find_notebooks', 'abhyasa/ground.py'),
+                                'abhyasa.ground.fold': ('ground.html#fold', 'abhyasa/ground.py'),
+                                'abhyasa.ground.fts_query': ('ground.html#fts_query', 'abhyasa/ground.py'),
+                                'abhyasa.ground.ground': ('ground.html#ground', 'abhyasa/ground.py'),
+                                'abhyasa.ground.ground_text': ('ground.html#ground_text', 'abhyasa/ground.py'),
+                                'abhyasa.ground.index_main': ('ground.html#index_main', 'abhyasa/ground.py'),
+                                'abhyasa.ground.index_notebooks': ('ground.html#index_notebooks', 'abhyasa/ground.py'),
+                                'abhyasa.ground.index_ramabana': ('ground.html#index_ramabana', 'abhyasa/ground.py'),
+                                'abhyasa.ground.names': ('ground.html#names', 'abhyasa/ground.py'),
+                                'abhyasa.ground.nb_text': ('ground.html#nb_text', 'abhyasa/ground.py'),
+                                'abhyasa.ground.passage': ('ground.html#passage', 'abhyasa/ground.py'),
+                                'abhyasa.ground.ramabana_sessions': ('ground.html#ramabana_sessions', 'abhyasa/ground.py')},
+            'abhyasa.llm': { 'abhyasa.llm.Fake': ('llm.html#fake', 'abhyasa/llm.py'),
+                             'abhyasa.llm.Fake.__call__': ('llm.html#fake.__call__', 'abhyasa/llm.py'),
+                             'abhyasa.llm.Fake.__init__': ('llm.html#fake.__init__', 'abhyasa/llm.py'),
+                             'abhyasa.llm.ask_json': ('llm.html#ask_json', 'abhyasa/llm.py'),
+                             'abhyasa.llm.parse_json': ('llm.html#parse_json', 'abhyasa/llm.py'),
+                             'abhyasa.llm.rishi_ask': ('llm.html#rishi_ask', 'abhyasa/llm.py')},
+            'abhyasa.model': { 'abhyasa.model._back': ('model.html#_back', 'abhyasa/model.py'),
+                               'abhyasa.model.grow': ('model.html#grow', 'abhyasa/model.py'),
+                               'abhyasa.model.learned': ('model.html#learned', 'abhyasa/model.py'),
+                               'abhyasa.model.next_depth': ('model.html#next_depth', 'abhyasa/model.py'),
+                               'abhyasa.model.outcome': ('model.html#outcome', 'abhyasa/model.py'),
+                               'abhyasa.model.pick': ('model.html#pick', 'abhyasa/model.py'),
+                               'abhyasa.model.ready': ('model.html#ready', 'abhyasa/model.py'),
+                               'abhyasa.model.recall': ('model.html#recall', 'abhyasa/model.py'),
+                               'abhyasa.model.update': ('model.html#update', 'abhyasa/model.py')},
+            'abhyasa.nb': { 'abhyasa.nb.Card': ('nb.html#card', 'abhyasa/nb.py'),
+                            'abhyasa.nb.Card.__init__': ('nb.html#card.__init__', 'abhyasa/nb.py'),
+                            'abhyasa.nb.Card._do': ('nb.html#card._do', 'abhyasa/nb.py'),
+                            'abhyasa.nb.Card._hint': ('nb.html#card._hint', 'abhyasa/nb.py'),
+                            'abhyasa.nb.Card._idk': ('nb.html#card._idk', 'abhyasa/nb.py'),
+                            'abhyasa.nb.Card._ipython_display_': ('nb.html#card._ipython_display_', 'abhyasa/nb.py'),
+                            'abhyasa.nb.Card._next': ('nb.html#card._next', 'abhyasa/nb.py'),
+                            'abhyasa.nb.Card._send': ('nb.html#card._send', 'abhyasa/nb.py'),
+                            'abhyasa.nb.Card._show': ('nb.html#card._show', 'abhyasa/nb.py'),
+                            'abhyasa.nb.Exercise': ('nb.html#exercise', 'abhyasa/nb.py'),
+                            'abhyasa.nb.Exercise.__init__': ('nb.html#exercise.__init__', 'abhyasa/nb.py'),
+                            'abhyasa.nb.Exercise._ipython_display_': ('nb.html#exercise._ipython_display_', 'abhyasa/nb.py'),
+                            'abhyasa.nb.Exercise.check': ('nb.html#exercise.check', 'abhyasa/nb.py'),
+                            'abhyasa.nb.Exercise.hint': ('nb.html#exercise.hint', 'abhyasa/nb.py'),
+                            'abhyasa.nb.Exercise.run': ('nb.html#exercise.run', 'abhyasa/nb.py'),
+                            'abhyasa.nb._esc': ('nb.html#_esc', 'abhyasa/nb.py'),
+                            'abhyasa.nb.code_prompt': ('nb.html#code_prompt', 'abhyasa/nb.py'),
+                            'abhyasa.nb.exercise': ('nb.html#exercise', 'abhyasa/nb.py'),
+                            'abhyasa.nb.fb_html': ('nb.html#fb_html', 'abhyasa/nb.py'),
+                            'abhyasa.nb.fb_text': ('nb.html#fb_text', 'abhyasa/nb.py'),
+                            'abhyasa.nb.learn': ('nb.html#learn', 'abhyasa/nb.py'),
+                            'abhyasa.nb.tutor': ('nb.html#tutor', 'abhyasa/nb.py'),
+                            'abhyasa.nb.write_exercise': ('nb.html#write_exercise', 'abhyasa/nb.py')},
+            'abhyasa.rama': { 'abhyasa.rama._learning': ('rama.html#_learning', 'abhyasa/rama.py'),
+                              'abhyasa.rama._need': ('rama.html#_need', 'abhyasa/rama.py'),
+                              'abhyasa.rama._safe': ('rama.html#_safe', 'abhyasa/rama.py'),
+                              'abhyasa.rama._tutor': ('rama.html#_tutor', 'abhyasa/rama.py'),
+                              'abhyasa.rama.answer': ('rama.html#answer', 'abhyasa/rama.py'),
+                              'abhyasa.rama.due': ('rama.html#due', 'abhyasa/rama.py'),
+                              'abhyasa.rama.find': ('rama.html#find', 'abhyasa/rama.py'),
+                              'abhyasa.rama.hint': ('rama.html#hint', 'abhyasa/rama.py'),
+                              'abhyasa.rama.idk': ('rama.html#idk', 'abhyasa/rama.py'),
+                              'abhyasa.rama.learn': ('rama.html#learn', 'abhyasa/rama.py'),
+                              'abhyasa.rama.learning_due': ('rama.html#learning_due', 'abhyasa/rama.py'),
+                              'abhyasa.rama.learning_note': ('rama.html#learning_note', 'abhyasa/rama.py'),
+                              'abhyasa.rama.setup': ('rama.html#setup', 'abhyasa/rama.py'),
+                              'abhyasa.rama.show_q': ('rama.html#show_q', 'abhyasa/rama.py'),
+                              'abhyasa.rama.show_r': ('rama.html#show_r', 'abhyasa/rama.py'),
+                              'abhyasa.rama.teach': ('rama.html#teach', 'abhyasa/rama.py')},
+            'abhyasa.sources': { 'abhyasa.sources._explain_concepts': ('sources.html#_explain_concepts', 'abhyasa/sources.py'),
+                                 'abhyasa.sources._explain_name': ('sources.html#_explain_name', 'abhyasa/sources.py'),
+                                 'abhyasa.sources._index': ('sources.html#_index', 'abhyasa/sources.py'),
+                                 'abhyasa.sources._lesson_concepts': ('sources.html#_lesson_concepts', 'abhyasa/sources.py'),
+                                 'abhyasa.sources._term_concepts': ('sources.html#_term_concepts', 'abhyasa/sources.py'),
+                                 'abhyasa.sources._windows': ('sources.html#_windows', 'abhyasa/sources.py'),
+                                 'abhyasa.sources.extract': ('sources.html#extract', 'abhyasa/sources.py'),
+                                 'abhyasa.sources.extract_prompt': ('sources.html#extract_prompt', 'abhyasa/sources.py'),
+                                 'abhyasa.sources.from_vault': ('sources.html#from_vault', 'abhyasa/sources.py'),
+                                 'abhyasa.sources.from_vedicreader': ('sources.html#from_vedicreader', 'abhyasa/sources.py'),
+                                 'abhyasa.sources.plain': ('sources.html#plain', 'abhyasa/sources.py')},
+            'abhyasa.store': { 'abhyasa.store.Learning': ('store.html#learning', 'abhyasa/store.py'),
+                               'abhyasa.store.Learning.__init__': ('store.html#learning.__init__', 'abhyasa/store.py'),
+                               'abhyasa.store.Learning.__repr__': ('store.html#learning.__repr__', 'abhyasa/store.py'),
+                               'abhyasa.store.Learning._docs': ('store.html#learning._docs', 'abhyasa/store.py'),
+                               'abhyasa.store.Learning._row': ('store.html#learning._row', 'abhyasa/store.py'),
+                               'abhyasa.store.Learning.attempts': ('store.html#learning.attempts', 'abhyasa/store.py'),
+                               'abhyasa.store.Learning.concept': ('store.html#learning.concept', 'abhyasa/store.py'),
+                               'abhyasa.store.Learning.concepts': ('store.html#learning.concepts', 'abhyasa/store.py'),
+                               'abhyasa.store.Learning.drop': ('store.html#learning.drop', 'abhyasa/store.py'),
+                               'abhyasa.store.Learning.graph': ('store.html#learning.graph', 'abhyasa/store.py'),
+                               'abhyasa.store.Learning.link': ('store.html#learning.link', 'abhyasa/store.py'),
+                               'abhyasa.store.Learning.log_session': ('store.html#learning.log_session', 'abhyasa/store.py'),
+                               'abhyasa.store.Learning.put': ('store.html#learning.put', 'abhyasa/store.py'),
+                               'abhyasa.store.Learning.record': ('store.html#learning.record', 'abhyasa/store.py'),
+                               'abhyasa.store.Learning.search': ('store.html#learning.search', 'abhyasa/store.py'),
+                               'abhyasa.store.Learning.subjects': ('store.html#learning.subjects', 'abhyasa/store.py'),
+                               'abhyasa.store.Learning.update': ('store.html#learning.update', 'abhyasa/store.py'),
+                               'abhyasa.store._src': ('store.html#_src', 'abhyasa/store.py'),
+                               'abhyasa.store._union': ('store.html#_union', 'abhyasa/store.py'),
+                               'abhyasa.store.attempt_text': ('store.html#attempt_text', 'abhyasa/store.py'),
+                               'abhyasa.store.concept_text': ('store.html#concept_text', 'abhyasa/store.py'),
+                               'abhyasa.store.slugify': ('store.html#slugify', 'abhyasa/store.py'),
+                               'abhyasa.store.temp_learning': ('store.html#temp_learning', 'abhyasa/store.py')},
+            'abhyasa.tutor': { 'abhyasa.tutor.Session': ('tutor.html#session', 'abhyasa/tutor.py'),
+                               'abhyasa.tutor.Session.__init__': ('tutor.html#session.__init__', 'abhyasa/tutor.py'),
+                               'abhyasa.tutor.Session._skip': ('tutor.html#session._skip', 'abhyasa/tutor.py'),
+                               'abhyasa.tutor.Session.answer': ('tutor.html#session.answer', 'abhyasa/tutor.py'),
+                               'abhyasa.tutor.Session.give_up': ('tutor.html#session.give_up', 'abhyasa/tutor.py'),
+                               'abhyasa.tutor.Session.hint': ('tutor.html#session.hint', 'abhyasa/tutor.py'),
+                               'abhyasa.tutor.Session.next': ('tutor.html#session.next', 'abhyasa/tutor.py'),
+                               'abhyasa.tutor.Session.summary': ('tutor.html#session.summary', 'abhyasa/tutor.py'),
+                               'abhyasa.tutor.Tutor': ('tutor.html#tutor', 'abhyasa/tutor.py'),
+                               'abhyasa.tutor.Tutor.__init__': ('tutor.html#tutor.__init__', 'abhyasa/tutor.py'),
+                               'abhyasa.tutor.Tutor._close': ('tutor.html#tutor._close', 'abhyasa/tutor.py'),
+                               'abhyasa.tutor.Tutor._grade': ('tutor.html#tutor._grade', 'abhyasa/tutor.py'),
+                               'abhyasa.tutor.Tutor._ground': ('tutor.html#tutor._ground', 'abhyasa/tutor.py'),
+                               'abhyasa.tutor.Tutor.answer': ('tutor.html#tutor.answer', 'abhyasa/tutor.py'),
+                               'abhyasa.tutor.Tutor.ask_on': ('tutor.html#tutor.ask_on', 'abhyasa/tutor.py'),
+                               'abhyasa.tutor.Tutor.give_up': ('tutor.html#tutor.give_up', 'abhyasa/tutor.py'),
+                               'abhyasa.tutor.Tutor.hint': ('tutor.html#tutor.hint', 'abhyasa/tutor.py'),
+                               'abhyasa.tutor.Tutor.next': ('tutor.html#tutor.next', 'abhyasa/tutor.py'),
+                               'abhyasa.tutor._concept_block': ('tutor.html#_concept_block', 'abhyasa/tutor.py'),
+                               'abhyasa.tutor._ready_q': ('tutor.html#_ready_q', 'abhyasa/tutor.py'),
+                               'abhyasa.tutor.grade_prompt': ('tutor.html#grade_prompt', 'abhyasa/tutor.py'),
+                               'abhyasa.tutor.hint_prompt': ('tutor.html#hint_prompt', 'abhyasa/tutor.py'),
+                               'abhyasa.tutor.public': ('tutor.html#public', 'abhyasa/tutor.py'),
+                               'abhyasa.tutor.question_prompt': ('tutor.html#question_prompt', 'abhyasa/tutor.py'),
+                               'abhyasa.tutor.teach_prompt': ('tutor.html#teach_prompt', 'abhyasa/tutor.py')},
+            'abhyasa.voice': { 'abhyasa.voice._gemma': ('voice.html#_gemma', 'abhyasa/voice.py'),
+                               'abhyasa.voice._mlx_whisper': ('voice.html#_mlx_whisper', 'abhyasa/voice.py'),
+                               'abhyasa.voice.transcribe': ('voice.html#transcribe', 'abhyasa/voice.py'),
+                               'abhyasa.voice.wav_seconds': ('voice.html#wav_seconds', 'abhyasa/voice.py')}}}

abhyasa-0.0.1/abhyasa/app.py

@@ -0,0 +1,43 @@
+"The web app: `fast_app`, the services, and `connect_all` over the blocks in `NAMES` order. Loopback only."
+import argparse
+from concurrent.futures import ThreadPoolExecutor
+from fasthtml.common import *
+from abhyasa.core import cfg, RouteOverrides, connect_all, serve_assets, HDRS
+from abhyasa.core import hooks
+from abhyasa.blocks import blocks
+from abhyasa.store import Learning
+from abhyasa.tutor import Tutor
+from abhyasa.llm import rishi_ask
+from abhyasa.ground import VaultSource, VedicSource
+
+__all__ = ['mk_app', 'main']
+
+FAVICON = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><circle cx="8" cy="8" r="6" fill="#7a4a2e"/></svg>'
+
+def mk_app(learning:Learning, ask=None, transcribe=None, names=None, sources=None):
+    "The app over `learning`; `ask` is the model, `transcribe` the speech to text, `sources` ground the tutor, `names` the blocks to connect."
+    if transcribe is None: from abhyasa.voice import transcribe
+    ask = ask or rishi_ask()
+    hooks.clear(); RouteOverrides.nav.clear()
+    app, rt = fast_app(hdrs=HDRS(), pico=False, default_hdrs=False)   # htmx and fasthtml.js come from core/vendor
+    if sources is None: sources = [VaultSource(learning), *([vs] if (vs := VedicSource()).dbs() else [])]
+    svc = dict(learning=learning, tutor=Tutor(learning, ask, sources=sources), ask=ask, transcribe=transcribe,
+               pool=ThreadPoolExecutor(2), sessions={}, sources=sources)
+    app.state.blocks = connect_all(app, blocks(*([names] if names else [])), **svc)
+    app.state.svc = svc
+    serve_assets(app)
+    app.get('/health')(lambda: JSONResponse(dict(status='ok')))
+    app.get('/favicon.ico')(lambda: Response(FAVICON, media_type='image/svg+xml'))
+    return app
+
+def main():
+    "Serve the app on loopback."
+    import uvicorn
+    p = argparse.ArgumentParser(description='abhyasa: a learning harness that makes you think')
+    p.add_argument('--port', type=int, default=cfg.port)
+    p.add_argument('--vault', default=cfg.vault, help='the vault file; default $ABHYASA_VAULT, then vishalakshi\'s')
+    p.add_argument('--model', default=None, help='a rishi model name; default $ABHYASA_MODEL or claude/sonnet')
+    a = p.parse_args()
+    lr = Learning(a.vault)
+    print(f'abhyasa on http://{cfg.host}:{a.port}  ({lr})')
+    uvicorn.run(mk_app(lr, rishi_ask(a.model)), host=cfg.host, port=a.port, log_level='warning')