Skip to content

docs(tutorial): DSA summer-school notebook + Colab notebook links#240

Merged
PatrickCmd merged 1 commit into
mainfrom
docs/dsa-summer-school-notebook
Jul 22, 2026
Merged

docs(tutorial): DSA summer-school notebook + Colab notebook links#240
PatrickCmd merged 1 commit into
mainfrom
docs/dsa-summer-school-notebook

Conversation

@PatrickCmd

Copy link
Copy Markdown
Contributor

Summary

Adds hands-on learning material for testing Sunbird AI models via notebooks or the API, aimed at the DSA summer school.

  • New interactive notebooksunbird_ai_apis.ipynb (repo root): a fully documented, interactive tour of every major endpoint.
  • Tutorial page — new Interactive Notebooks subsection under Resources linking five Colab notebooks so users can test models via notebooks or the API.

Notebook (sunbird_ai_apis.ipynb)

  • Setup section: dependency install, documented token step, and a shared get_headers() / BASE_URL / LANGUAGES config reused throughout.
  • Each API section (Translation 🌍, STT 🎙️, TTS 🔊) pairs a plain HTTP call with an ipywidgets panel (dropdowns, file upload, text areas, run buttons).
  • Chat Completions 💬 demonstrates both sunflower-14b and sunflower-9b:
    • Model comparison table + SALT model-page links
    • chat() helper and a compare_models() side-by-side helper
    • Interactive chat widget (model dropdown + temperature slider + prompt)
    • Multi-turn, OpenAI SDK, and streaming examples
  • Uses the current model names — Sunbird/Sunflower-14B is no longer accepted (appears only in a deprecation callout).

Tutorial page (frontend/src/pages/Tutorial.tsx)

Adds an Interactive Notebooks card grid (matching existing resource-card styling) linking:

  1. Sunbird AI APIs — Hands-on (Interactive)
  2. Sunbird AI APIs — Non-Interactive
  3. Sunflower-Qwen3.5-9B Inference
  4. Sunflower Gemma 4 E2B — Text & Speech
  5. ASR for 51 African Languages

All links open in a new tab. React SPA rebuilt (app/static/react_build/).

Testing

  • Notebook: JSON + Python AST validation (50 unique cells, 0 syntax errors).
  • Frontend: npm run build (tsc typecheck + vite build) passes. npm run lint has a pre-existing ESLint flat-config failure unrelated to this change.

🤖 Generated with Claude Code

Add an interactive, fully documented Jupyter notebook
(sunbird_ai_apis.ipynb) for the DSA summer school covering translation,
STT, TTS, and the OpenAI-compatible Sunflower chat models. Each API
section pairs a plain HTTP call with an ipywidgets panel, and the chat
section demonstrates both sunflower-14b and sunflower-9b with a
side-by-side comparison helper. Uses the current model names
(Sunbird/Sunflower-14B is no longer accepted).

Add an "Interactive Notebooks" subsection to the Tutorial Resources
section linking the five Colab notebooks (Sunbird API hands-on
interactive/non-interactive, Sunflower-9B inference, Sunflower Gemma
text & speech, and ASR for 51 African languages), so users can test the
models via notebooks or the API. Rebuild the React SPA.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@PatrickCmd
PatrickCmd merged commit a0f5039 into main Jul 22, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant