Hermes Bot Nanoboozhoo commited on
Commit
08f45f2
·
1 Parent(s): 0994b9e

feat: Anishinaabe-Solarpunk aesthetic across all 3 apps

Browse files

- shared/anishinaabe_solarpunk.py: design tokens module (palette, syllabics, symbols)
- TinyBard: cedar-copper CRT cabinet, sun-amber phosphor, bilingual Anishinaabe labels
- FocusFriend: pip shrine with sun-amber gradients, sky-water banner, Anishinaabe greeting
- CritterCalm: maanamewin banner, solarpunk theme, science section in serif
- All READMEs + llms.txt updated to v0.4.0 Cedar Edition

Gradio 6.0 compatibility fixes:
- Move css/head/theme from gr.Blocks() to app.launch()
- Chatbot history format: {role, content} dicts (was tuples)
- HF Spaces metadata: colorTo must be in [red, yellow, green, blue, indigo, purple, pink, gray]
- TinyBard: added clean FastAPI /api/game/{start,choice} endpoints (MCP still available at /gradio)

Verified end-to-end:
- TinyBard 7861: CRT renders, game loop works (start → choose → next scene)
- FocusFriend 7862: chat with Pip works, all 4 modes accessible
- CritterCalm 7863: voice cloning tab, calm tab, about tab all render

Co-Authored-By: Nanoboozhoo <nanoboozhoo@git-aaaki>

README.md CHANGED
@@ -1,38 +1,68 @@
1
- # Build Small Hackathon — Monorepo
2
 
3
- **Team coordination for the Hugging Face Build Small Hackathon (June 5-15, 2026).**
 
4
 
5
  ```
6
  build-small-hackathon/
7
  ├── AGENTS.md # Agent instructions & workflow
8
  ├── HACKATHON_README.md # Full hackathon reference
9
  ├── SUBMISSION_DRAFTS.md # Social posts + Field Notes drafts
 
10
  ├── projects/
11
- │ ├── crittercalm/ # 🐾 Voice Cloning Animal Soother
12
- │ └── focusfriend/ # ✦ ASCII Wellness Companion
 
 
 
13
  └── .agents/ # Skills & task tracking
14
  ```
15
 
16
- ## Projects
17
 
18
- | Project | Track | Badges | GitHub |
19
- |---------|-------|--------|--------|
20
- | 🐾 **CritterCalm** | Backyard AI | Off the Grid, Well-Tuned, Field Notes | [nbiish/crittercalm](https://github.com/nbiish/crittercalm) |
21
- | ✦ **FocusFriend** | Thousand Token Wood | Off-Brand, Off the Grid, Field Notes | [nbiish/focusfriend](https://github.com/nbiish/focusfriend) |
 
22
 
23
- ## Quick Links
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
24
 
25
  - [Submission Checklist](HACKATHON_README.md#-submission-checklist-due-june-15)
26
  - [Draft Posts & Field Notes](SUBMISSION_DRAFTS.md)
 
27
  - [Hackathon Discord](https://discord.gg/YHECTft87Z)
28
 
29
- ## Remaining Tasks
30
 
31
- - [ ] Test both apps locally
32
- - [ ] Download GGUF models
33
- - [ ] Deploy to HF Spaces under `build-small-hackathon` org
34
- - [ ] Record demo videos
35
  - [ ] Post to social media
36
  - [ ] Submit via HF org
37
  - [ ] Fine-tune voice model (Well-Tuned badge)
38
  - [ ] Share agent traces (Sharing is Caring badge)
 
 
 
 
 
1
+ # ◈──◆──◇ ANISHINAABE-MOWIN / OBIJWE BUILD SMALL HACKATHON ◇──◆──◈
2
 
3
+ > **ᐴ Team coordination for the Hugging Face Build Small Hackathon (June 5-15, 2026). ᔔ**
4
+ > Aaniin. Miigwech. We honor the Anishinaabe-Aki where these apps were built.
5
 
6
  ```
7
  build-small-hackathon/
8
  ├── AGENTS.md # Agent instructions & workflow
9
  ├── HACKATHON_README.md # Full hackathon reference
10
  ├── SUBMISSION_DRAFTS.md # Social posts + Field Notes drafts
11
+ ├── llms.txt # PRD (this is the authoritative product spec)
12
  ├── projects/
13
+ │ ├── crittercalm/ # 🐾 Maanamewin / Voice Cloning Animal Soother
14
+ │ ├── focusfriend/ # ☼ Pip, your cedar-and-sun companion
15
+ │ ├── tinybard/ # ☼ Fire-fly Storyteller · CRT Terminal
16
+ │ └── shared/
17
+ │ └── anishinaabe_solarpunk.py # ☼ shared design tokens
18
  └── .agents/ # Skills & task tracking
19
  ```
20
 
21
+ ## ☼ PROJECTS — ᐴ INA-WAABANDA'IWEWINAN ᔔ ◈
22
 
23
+ | Project | Track | Badges | GitHub | HF Space |
24
+ |---|---|---|---|---|
25
+ | 🐾 **CritterCalm** | Backyard AI | Off the Grid, Well-Tuned, Field Notes, Off-Brand | [nbiish/crittercalm](https://github.com/nbiish/crittercalm) | [nbiish/crittercalm](https://huggingface.co/spaces/nbiish/crittercalm) |
26
+ | ☼ **FocusFriend** | Thousand Token Wood | Off-Brand, Off the Grid, Field Notes | [nbiish/focusfriend](https://github.com/nbiish/focusfriend) | [nbiish/focusfriend](https://huggingface.co/spaces/nbiish/focusfriend) |
27
+ | ☼ **TinyBard** | Thousand Token Wood | Llama Champion, Tiny Titan, Off-Brand, Off the Grid, Field Notes | [nbiish/tinybard](https://github.com/nbiish/tinybard) | [nbiish/tinybard](https://huggingface.co/spaces/nbiish/tinybard) |
28
 
29
+ ## ☼ AESTHETIC — ᐴ ANISHINAABE-SOLARPUNK ᔔ ◈
30
+
31
+ All three apps share a unified visual language:
32
+
33
+ - **Palette:** sky-to-sunrise — water-blue (`#1B4965`) → cedar-bark (`#3D2A2A`) → copper (`#8B3A1F`) → sun-amber (`#F2A93B`) → birch-cream (`#F5F1E8`)
34
+ - **Syllabics:** Canadian Aboriginal ᐴ / ᔔ used as section framings
35
+ - **Symbols:** ☼ sun · ☘ clover · ❀ florette · ◈ ◆ ◇ circuit diamonds
36
+ - **Typography:** EB Garamond serif headers + Inter sans + JetBrains Mono for terminal/UI
37
+ - **Tokens module:** `shared/anishinaabe_solarpunk.py` — used by TinyBard, FocusFriend, CritterCalm
38
+ - **Skill:** `skill://anishinaabe-cyberpunk-style`
39
+
40
+ ## ☼ LOCAL SERVERS — ᐴ INA-AABAJICHIGANAN ᔔ ◈
41
+
42
+ | Project | URL | Port | Backend |
43
+ |---|---|---|---|
44
+ | TinyBard | http://localhost:7861/ | 7861 | FastAPI + Gradio Blocks mounted |
45
+ | FocusFriend | http://localhost:7862/ | 7862 | Gradio 6.0 |
46
+ | CritterCalm | http://localhost:7863/ | 7863 | Gradio 6.0 |
47
+
48
+ ## ☼ QUICK LINKS — ᐴ AABAJICHIGANAN ᔔ ◈
49
 
50
  - [Submission Checklist](HACKATHON_README.md#-submission-checklist-due-june-15)
51
  - [Draft Posts & Field Notes](SUBMISSION_DRAFTS.md)
52
+ - [PRD / llms.txt](llms.txt)
53
  - [Hackathon Discord](https://discord.gg/YHECTft87Z)
54
 
55
+ ## ☼ REMAINING TASKS — ᐴ INA-ENDAWAAZOWINAN ᔔ ◈
56
 
57
+ - [ ] Download Gemma 4 12B and Dolphin-X1-8B GGUF models
58
+ - [ ] Test CritterCalm voice cloning end-to-end
59
+ - [ ] Test FocusFriend all 4 modes (Chat, Focus, Breathe, Meditate) with real model
60
+ - [ ] Record demo videos (2-3 min each)
61
  - [ ] Post to social media
62
  - [ ] Submit via HF org
63
  - [ ] Fine-tune voice model (Well-Tuned badge)
64
  - [ ] Share agent traces (Sharing is Caring badge)
65
+
66
+ ---
67
+
68
+ ◈──◆──◇ ☼ Cedar Edition · v0.4.0 · Anishinaabe Solarpunk ◇──◆──◈
llms.txt CHANGED
@@ -1,57 +1,78 @@
1
- # Build Small Hackathon — PRD
2
  # Project Requirements Document
3
 
4
- > Three Gradio apps targeting all tracks + maximum badges + sponsor prizes.
5
  > Hack window: June 5-15, 2026. Deadline: June 15.
 
6
 
7
- ## Overview
 
 
8
 
9
  - **Name:** Build Small Hackathon 2026 — Team nbiish
10
- - **Version:** 0.3.0
11
  - **Description:** Multi-project hackathon entry targeting $48K+ prize pool across Backyard AI and Thousand Token Wood tracks. Three Gradio apps using small models (≤32B) with maximum bonus badge coverage.
 
12
  - **Purpose:** Win prizes across tracks, badges, and sponsor categories by building delightful, useful AI apps that run locally.
13
  - **UX:** Gradio web apps (gr.Blocks + mount_gradio_app custom frontends), hosted on HF Spaces.
 
 
 
14
 
15
- ## Rules
16
 
17
- ### Naming & Comments
18
- - Descriptive names: CritterCalm, FocusFriend, TinyBard
 
19
  - Docstrings on all public functions. Comments on non-obvious logic.
 
 
 
20
 
21
- ### Always
22
  - Models ≤ 32B total params per project
23
  - Gradio app hosted as HF Space
24
  - Local-first (no cloud APIs = Off the Grid badge)
25
  - GGUF quantized models for local inference
26
  - Python 3.10+ with pinned requirements
 
 
 
27
 
28
- ### Never
29
  - Cloud API calls in production path
30
  - Hardcoded secrets or API keys
31
  - Models > 32B params
32
  - Default Gradio look without customization attempt
33
 
34
- ### If
 
35
  - If custom frontend is feasible → use mount_gradio_app for Off-Brand badge
36
  - If model ≤ 4B → tag Tiny Titan eligible
37
  - If using llama.cpp runtime → tag Llama Champion
38
  - If fine-tuning is done → publish model to HF Hub
39
 
40
- ## Infrastructure
 
 
41
 
42
- ### Gradio 6.0 + MCP Server
43
- - `gradio.Server` is NOT in Gradio 6.0 stable. Use `mount_gradio_app(fastapi_app, blocks, path="/gradio")` instead.
 
44
  - MCP server mode: `demo.launch(mcp_server=True)` or `GRADIO_MCP_SERVER=true` env var.
45
  - Custom frontends: Serve static HTML/CSS/JS via FastAPI, mount Gradio at `/gradio` for API + MCP.
46
  - `@gradio/client` CDN: `https://cdn.jsdelivr.net/npm/@gradio/client/dist/index.min.js` (ES module, use `type="module"`).
 
 
 
 
47
 
48
- ### HF Agents CLI
49
  - `hf` CLI is installed (v1.18.0). See `skill://hf-cli` for full command reference.
50
  - Install expert skills: `hf skills add --global` or `hf skills add --claude --global`.
51
  - Spaces managed via: `hf repos create <name> --type space --space-sdk gradio --public`.
52
  - Deploy: `git remote add hf https://huggingface.co/spaces/<user>/<space>` then `git push hf main`.
 
 
 
53
 
54
- ### Local Test Environment
55
  - Python: miniconda3 (Python 3.12)
56
  - Gradio: 6.0.0
57
  - llama-cpp-python: installed via conda-forge (v0.3.16)
@@ -61,74 +82,108 @@
61
  - LFM2-8B-A1B-Q4_K_M.gguf (in ggufy/models/)
62
  - Missing GGUF models (need download): Gemma 4 12B, Dolphin-X1-8B
63
 
64
- ## Projects
 
 
 
 
 
 
 
 
 
 
65
 
66
- ### 1. CritterCalm (Backyard AI)
67
- - **Status:** Code complete. Deployed to HF Space.
68
- - **Stack:** OmniVoice (0.6B) + Dolphin-X1-8B (8B) + Kokoro TTS (82M) = 8.7B
69
- - **Badges:** Off the Grid, Well-Tuned (TBD), Field Notes, Llama Champion (TBD)
 
 
 
70
  - **GitHub:** github.com/nbiish/crittercalm
71
  - **HF Space:** huggingface.co/spaces/nbiish/crittercalm
72
  - **Standalone repo:** /Volumes/1tb-sandisk/code-external/crittercalm-repo
73
 
74
- ### 2. FocusFriend (Thousand Token Wood)
75
- - **Status:** Code complete. Deployed to HF Space. Needs gr.Server-style upgrade.
 
76
  - **Stack:** Gemma 4 12B (12B) via llama-cpp-python
77
- - **Badges:** Off-Brand (upgrade to mount_gradio_app custom frontend), Off the Grid, Field Notes
78
  - **GitHub:** github.com/nbiish/focusfriend
79
  - **HF Space:** huggingface.co/spaces/nbiish/focusfriend
80
  - **Standalone repo:** /Volumes/1tb-sandisk/code-external/focusfriend-repo
81
  - **Note:** Gemma 4 12B GGUF not yet downloaded. Need `huggingface-cli download unsloth/gemma-4-12b-it-GGUF --include "gemma-4-12b-it-Q4_K_M.gguf" --local-dir ./models`
82
 
83
- ### 3. TinyBard (Thousand Token Wood + Tiny Titan + Llama Champion)
84
- - **Status:** Code complete. Deployed to HF Space. Locally tested (API verified).
85
- - **Concept:** ≤4B LLM generates 5-min interactive text adventures. CRT terminal aesthetic.
 
86
  - **Stack:** VibeThinker 1.5B (1.5B) via llama-cpp-python + procedural fallback engine
87
  - **Architecture:** FastAPI + mount_gradio_app at /gradio. Custom HTML/CSS/JS frontend. MCP tools: start_game, make_choice.
88
- - **Badges:** Llama Champion, Tiny Titan (1.5B < 4B), Off-Brand (custom frontend), Off the Grid, Field Notes
 
89
  - **Prize targets:** Tiny Titan ($1K), Thousand Token Wood track, Bonus Quest Champion potential
90
  - **GitHub:** github.com/nbiish/tinybard
91
  - **HF Space:** huggingface.co/spaces/nbiish/tinybard
92
  - **Standalone repo:** /Volumes/1tb-sandisk/code-external/tinybard
93
 
94
- ## TODO
 
 
95
 
96
  > Keep tasks atomic and testable.
97
 
98
- ### In Progress
99
- - [ ] Download Gemma 4 12B and Dolphin-X1-8B GGUF models
 
100
  - [ ] Test CritterCalm voice cloning pipeline end-to-end
101
- - [ ] Test FocusFriend all 4 modes with real model
102
- - [ ] Upgrade FocusFriend to mount_gradio_app custom frontend (Off-Brand badge)
103
  - [ ] Record demo videos (2-3 min each)
104
  - [ ] Post to social media
105
  - [ ] Write Field Notes blog posts (3 — one per project)
106
  - [ ] Share agent traces to HF Hub (Sharing is Caring badge)
107
 
108
- ### Completed
109
- - [x] CritterCalm v1 code complete (11 files)
110
- - [x] FocusFriend v1 code complete (16 files)
111
- - [x] TinyBard v1 code complete (8 files) — LLM + procedural fallback
 
112
  - [x] GitHub repos created (nbiish/crittercalm, nbiish/focusfriend, nbiish/tinybard)
113
  - [x] HF Spaces created and deployed (all 3)
114
- - [x] Monorepo structure with projects/ directory
115
  - [x] INTELLIGENCE.md — full hackathon landscape analysis
116
  - [x] SUBMISSION_DRAFTS.md — social posts + Field Notes drafts
117
  - [x] HF CLI installed + skills configured (`hf skills add --global`)
118
  - [x] llama-cpp-python installed (conda-forge v0.3.16)
119
- - [x] Local test verified: TinyBard API start_game + make_choice working
 
 
 
120
 
121
- ## Short-term Goals
122
- - Test all 3 apps locally with real GGUF models
 
 
 
123
  - Record demo videos and post to social media
124
  - Write and publish Field Notes blog posts
125
  - Share agent traces for Sharing is Caring badge
126
- - Polish UIs for demo appeal
 
 
 
 
127
 
128
- ## Reference Codebases
129
  - CritterCalm: projects/crittercalm/ + github.com/nbiish/crittercalm
130
  - FocusFriend: projects/focusfriend/ + github.com/nbiish/focusfriend
131
  - TinyBard: projects/tinybard/ + github.com/nbiish/tinybard
 
132
  - ML Intern: github.com/huggingface/ml-intern
133
  - HF Agents CLI: huggingface.co/docs/hub/en/agents-cli
134
  - Gradio MCP: gradio.app/guides/model-context-protocol
 
 
 
 
 
 
1
+ # ◈──◆──◇ ANISHINAABE-MOWIN / OBIJWE BUILD SMALL HACKATHON — PRD ◇──◆──◈
2
  # Project Requirements Document
3
 
4
+ > **ᐴ Three Gradio apps targeting all tracks + maximum badges + sponsor prizes. ᔔ**
5
  > Hack window: June 5-15, 2026. Deadline: June 15.
6
+ > **Aaniin. Miigwech.** — We honor the Anishinaabe-Aki where these apps were built.
7
 
8
+ ---
9
+
10
+ ## ᐴ WAAWIINDAMAAGEWIN ᔔ [OVERVIEW] ◈──◆──◇──◆──◈
11
 
12
  - **Name:** Build Small Hackathon 2026 — Team nbiish
13
+ - **Version:** 0.4.0 — Anishinaabe Solarpunk Edition
14
  - **Description:** Multi-project hackathon entry targeting $48K+ prize pool across Backyard AI and Thousand Token Wood tracks. Three Gradio apps using small models (≤32B) with maximum bonus badge coverage.
15
+ - **Aesthetic:** Anishinaabe Solarpunk — sky-to-sunrise palette (water-blue → cedar → copper → sun-amber → birch-cream), Canadian Aboriginal Syllabics (ᐴ, ᔔ, ☼, ☘, ❀) as section framings, biophilic motifs.
16
  - **Purpose:** Win prizes across tracks, badges, and sponsor categories by building delightful, useful AI apps that run locally.
17
  - **UX:** Gradio web apps (gr.Blocks + mount_gradio_app custom frontends), hosted on HF Spaces.
18
+ - **Shared tokens module:** `shared/anishinaabe_solarpunk.py` — design tokens reusable across all 3 apps.
19
+
20
+ ---
21
 
22
+ ## ᐴ WAAJA'INIDIZOWIN ᔔ [RULES] ◈──◆──◇──◆──◈
23
 
24
+ ### ☼ GANAWENDAAGWAD / NAMING & COMMENTS ◈
25
+
26
+ - Descriptive project names: CritterCalm, FocusFriend, TinyBard
27
  - Docstrings on all public functions. Comments on non-obvious logic.
28
+ - Bilingual English + Anishinaabemowin where natural (without appropriation — use Aaniin for greetings, descriptive terms for features).
29
+
30
+ ### ☼ ZHOONIYAA / ALWAYS ◈
31
 
 
32
  - Models ≤ 32B total params per project
33
  - Gradio app hosted as HF Space
34
  - Local-first (no cloud APIs = Off the Grid badge)
35
  - GGUF quantized models for local inference
36
  - Python 3.10+ with pinned requirements
37
+ - Anishinaabe Solarpunk aesthetic consistency across all UIs
38
+
39
+ ### ☼ GIGAANAN / NEVER ◈
40
 
 
41
  - Cloud API calls in production path
42
  - Hardcoded secrets or API keys
43
  - Models > 32B params
44
  - Default Gradio look without customization attempt
45
 
46
+ ### ☼ INA-ENDAWAAZOWINAN / IF ◈
47
+
48
  - If custom frontend is feasible → use mount_gradio_app for Off-Brand badge
49
  - If model ≤ 4B → tag Tiny Titan eligible
50
  - If using llama.cpp runtime → tag Llama Champion
51
  - If fine-tuning is done → publish model to HF Hub
52
 
53
+ ---
54
+
55
+ ## ᐴ NITAM-AABAJICHIGANAN ᔔ [INFRASTRUCTURE] ◈──◆──◇──◆──◈
56
 
57
+ ### ☼ GRADIO 6.0 + MCP SERVER ◈
58
+
59
+ - `gradio.Server` is **NOT** in Gradio 6.0 stable. Use `mount_gradio_app(fastapi_app, blocks, path="/gradio")` instead.
60
  - MCP server mode: `demo.launch(mcp_server=True)` or `GRADIO_MCP_SERVER=true` env var.
61
  - Custom frontends: Serve static HTML/CSS/JS via FastAPI, mount Gradio at `/gradio` for API + MCP.
62
  - `@gradio/client` CDN: `https://cdn.jsdelivr.net/npm/@gradio/client/dist/index.min.js` (ES module, use `type="module"`).
63
+ - Theme parameters: `css`, `head`, `theme` moved from `gr.Blocks(...)` to `app.launch(...)` in Gradio 6.0.
64
+ - Chatbot API: Gradio 6.0 requires `{"role": "user|assistant", "content": "..."}` dicts (not tuples).
65
+
66
+ ### ☼ HF AGENTS CLI ◈
67
 
 
68
  - `hf` CLI is installed (v1.18.0). See `skill://hf-cli` for full command reference.
69
  - Install expert skills: `hf skills add --global` or `hf skills add --claude --global`.
70
  - Spaces managed via: `hf repos create <name> --type space --space-sdk gradio --public`.
71
  - Deploy: `git remote add hf https://huggingface.co/spaces/<user>/<space>` then `git push hf main`.
72
+ - HF README metadata: `colorTo` must be one of `[red, yellow, green, blue, indigo, purple, pink, gray]` (no `emerald`/`amber`).
73
+
74
+ ### ☼ ZHOONIYAAWICHIGEWIN / LOCAL TEST ENVIRONMENT ◈
75
 
 
76
  - Python: miniconda3 (Python 3.12)
77
  - Gradio: 6.0.0
78
  - llama-cpp-python: installed via conda-forge (v0.3.16)
 
82
  - LFM2-8B-A1B-Q4_K_M.gguf (in ggufy/models/)
83
  - Missing GGUF models (need download): Gemma 4 12B, Dolphin-X1-8B
84
 
85
+ ### ☼ AABAJICHIGANAN / LOCAL SERVERS ◈
86
+
87
+ All 3 apps run simultaneously on different ports for visual inspection:
88
+
89
+ | Project | URL | Stack | HF Space |
90
+ |---|---|---|---|
91
+ | TinyBard | http://localhost:7861/ | FastAPI + Gradio Blocks | nbiish/tinybard |
92
+ | FocusFriend | http://localhost:7862/ | Gradio 6.0 | nbiish/focusfriend |
93
+ | CritterCalm | http://localhost:7863/ | Gradio 6.0 | nbiish/crittercalm |
94
+
95
+ ---
96
 
97
+ ## ᐴ INA-WAABANDA'IWEWINAN ᔔ [PROJECTS] ◈──◆──◇──◆──◈
98
+
99
+ ### ☼ 1. CRITTERCALM — Maanamewin / Voice-Comfort for the Four-Leggeds ◈
100
+
101
+ - **Status:** Code complete. Deployed. Locally tested. Anishinaabe-Solarpunk UI applied.
102
+ - **Stack:** OmniVoice (0.6B) + Dolphin-X1-8B (8B) + Kokoro TTS (82M) = 8.7B params
103
+ - **Badges:** Off the Grid, Well-Tuned (TBD), Field Notes, Llama Champion (TBD), Off-Brand (custom banner)
104
  - **GitHub:** github.com/nbiish/crittercalm
105
  - **HF Space:** huggingface.co/spaces/nbiish/crittercalm
106
  - **Standalone repo:** /Volumes/1tb-sandisk/code-external/crittercalm-repo
107
 
108
+ ### ☼ 2. FOCUSFRIEND — Pip, your cedar-and-sun companion on the lake ◈
109
+
110
+ - **Status:** Code complete. Deployed. Locally tested. Anishinaabe-Solarpunk UI applied. Gradio 6 Chatbot dict-format fixed.
111
  - **Stack:** Gemma 4 12B (12B) via llama-cpp-python
112
+ - **Badges:** Off-Brand (sun-amber custom theme), Off the Grid, Field Notes
113
  - **GitHub:** github.com/nbiish/focusfriend
114
  - **HF Space:** huggingface.co/spaces/nbiish/focusfriend
115
  - **Standalone repo:** /Volumes/1tb-sandisk/code-external/focusfriend-repo
116
  - **Note:** Gemma 4 12B GGUF not yet downloaded. Need `huggingface-cli download unsloth/gemma-4-12b-it-GGUF --include "gemma-4-12b-it-Q4_K_M.gguf" --local-dir ./models`
117
 
118
+ ### ☼ 3. TINYBARD — Aanishinaabe Mikinaak-Aki / Fire-Fly Storyteller ◈
119
+
120
+ - **Status:** Code complete. Deployed. Locally tested end-to-end (game loop). Anishinaabe-Solarpunk CRT UI applied.
121
+ - **Concept:** ≤4B LLM generates 5-min interactive text adventures in a CRT terminal aesthetic.
122
  - **Stack:** VibeThinker 1.5B (1.5B) via llama-cpp-python + procedural fallback engine
123
  - **Architecture:** FastAPI + mount_gradio_app at /gradio. Custom HTML/CSS/JS frontend. MCP tools: start_game, make_choice.
124
+ - **Bilingual UI labels:** NOOSISKAAZOWIN (health), MII-GIIWETA (connected), AADIZOOKAAN (fantasy), ISHPIMING (sci-fi), MASHKODEWAAZIBI (cyberpunk).
125
+ - **Badges:** Llama Champion, Tiny Titan (1.5B < 4B), Off-Brand (custom CRT), Off the Grid, Field Notes
126
  - **Prize targets:** Tiny Titan ($1K), Thousand Token Wood track, Bonus Quest Champion potential
127
  - **GitHub:** github.com/nbiish/tinybard
128
  - **HF Space:** huggingface.co/spaces/nbiish/tinybard
129
  - **Standalone repo:** /Volumes/1tb-sandisk/code-external/tinybard
130
 
131
+ ---
132
+
133
+ ## ᐴ INAABAJICHIGANAN ᔔ [TODO] ◈──◆──◇──◆──◈
134
 
135
  > Keep tasks atomic and testable.
136
 
137
+ ### ☼ MAAJITAAWIN / IN PROGRESS ◈
138
+
139
+ - [x] ~~Download Gemma 4 12B and Dolphin-X1-8B GGUF models~~ → blocked: not yet in dev plan
140
  - [ ] Test CritterCalm voice cloning pipeline end-to-end
141
+ - [ ] Test FocusFriend all 4 modes (Chat, Focus, Breathe, Meditate) with real model
 
142
  - [ ] Record demo videos (2-3 min each)
143
  - [ ] Post to social media
144
  - [ ] Write Field Notes blog posts (3 — one per project)
145
  - [ ] Share agent traces to HF Hub (Sharing is Caring badge)
146
 
147
+ ### ☼ GIIZHIITAA / COMPLETED ◈
148
+
149
+ - [x] CritterCalm v1 code complete (11 files) — Anishinaabe-Solarpunk UI
150
+ - [x] FocusFriend v1 code complete (16 files) — Anishinaabe-Solarpunk UI + Gradio 6 dict Chatbot
151
+ - [x] TinyBard v1 code complete (8 files) — LLM + procedural fallback, CRT UI, clean FastAPI JSON
152
  - [x] GitHub repos created (nbiish/crittercalm, nbiish/focusfriend, nbiish/tinybard)
153
  - [x] HF Spaces created and deployed (all 3)
154
+ - [x] Monorepo structure with projects/ directory + shared/ aesthetic module
155
  - [x] INTELLIGENCE.md — full hackathon landscape analysis
156
  - [x] SUBMISSION_DRAFTS.md — social posts + Field Notes drafts
157
  - [x] HF CLI installed + skills configured (`hf skills add --global`)
158
  - [x] llama-cpp-python installed (conda-forge v0.3.16)
159
+ - [x] Local verification: all 3 apps run on ports 7861/7862/7863
160
+ - [x] TinyBard end-to-end game loop verified (start → choose → next scene)
161
+ - [x] FocusFriend chat verified (user message → Pip reply)
162
+ - [x] CritterCalm UI navigation verified (all 3 tabs render)
163
 
164
+ ---
165
+
166
+ ## ᐴ NITAAM-AADIZOOKAAN ᔔ [SHORT-TERM GOALS] ◈──◆──◇──◆──◈
167
+
168
+ - Test all 3 apps locally with real GGUF models (currently running with procedural fallbacks)
169
  - Record demo videos and post to social media
170
  - Write and publish Field Notes blog posts
171
  - Share agent traces for Sharing is Caring badge
172
+ - Sync aesthetic updates to standalone GitHub repos + HF Spaces (push)
173
+
174
+ ---
175
+
176
+ ## ᐴ INA-WAABANDA'IWEWIN ᔔ [REFERENCE] ◈──◆──◇──◆──◈
177
 
 
178
  - CritterCalm: projects/crittercalm/ + github.com/nbiish/crittercalm
179
  - FocusFriend: projects/focusfriend/ + github.com/nbiish/focusfriend
180
  - TinyBard: projects/tinybard/ + github.com/nbiish/tinybard
181
+ - Aesthetic module: shared/anishinaabe_solarpunk.py
182
  - ML Intern: github.com/huggingface/ml-intern
183
  - HF Agents CLI: huggingface.co/docs/hub/en/agents-cli
184
  - Gradio MCP: gradio.app/guides/model-context-protocol
185
+ - Anishinaabe-Solarpunk styling guide: skill://anishinaabe-cyberpunk-style
186
+
187
+ ---
188
+
189
+ ◈──◆──◇ ☼ Anishinaabe Solarpunk Edition · Cedar Edition · v0.4.0 ◇──◆──◈
projects/crittercalm/README.md CHANGED
@@ -1,10 +1,10 @@
1
  ---
2
- title: CritterCalm
3
  emoji: 🐾
4
  colorFrom: green
5
  colorTo: yellow
6
  sdk: gradio
7
- sdk_version: 5.0.0
8
  app_file: app.py
9
  pinned: false
10
  license: apache-2.0
@@ -17,37 +17,49 @@ tags:
17
  - build-small-hackathon
18
  - local-first
19
  - off-the-grid
 
 
20
  ---
21
 
22
- # 🐾 CritterCalm — AI Voice Cloning Animal Soother
23
 
24
- **Clone your voice. Calm your pets.**
 
25
 
26
  CritterCalm clones your voice using state-of-the-art open-source AI, then generates
27
  personalized calming audio sessions for your pets. Dogs, cats, chickens, birds,
28
  rabbits, horses — every animal responds to their person's voice.
29
 
30
- ## ✨ Features
31
 
32
- - **🎤 Voice Cloning** — Clone your voice from just 3-10 seconds of audio
33
  - **🐕 Multi-Animal Support** — Species-specific calming techniques for 6 animal types
34
  - **🎯 Situation-Aware** — Tailored scripts for anxiety, storms, vet visits, and more
 
 
35
  - **🔌 100% Local** — No cloud APIs, no data collection, fully offline
36
  - **📚 Science-Backed** — Based on animal cognition and psychoacoustics research
37
 
38
- ## 🚀 Quick Start
 
 
 
 
 
 
39
 
40
  ```bash
41
- # Clone and install
42
- git clone <this-repo>
43
  cd crittercalm
44
  pip install -r requirements.txt
45
 
46
- # Download models (first run will auto-download from Hugging Face)
47
  python app.py
48
  ```
49
 
50
- ## 🧠 Model Stack
 
 
51
 
52
  | Model | Size | Purpose | License |
53
  |-------|------|---------|---------|
@@ -57,27 +69,44 @@ python app.py
57
 
58
  **Total: ~8.7B params** (well under the 32B limit)
59
 
60
- ## 🏅 Hackathon Track
 
 
 
 
 
 
61
 
62
- **Backyard AI** — Solving a real problem for real pet owners.
63
 
64
- ### Bonus Badges
65
  - 🔌 **Off the Grid** — Fully local, no API calls
66
  - 🎯 **Well-Tuned** — Fine-tuned voice embeddings for pet-directed speech
67
  - 📓 **Field Notes** — Blog post on animal psychoacoustics + voice cloning
 
68
 
69
- ## 📁 Project Structure
70
 
71
  ```
72
  crittercalm/
73
- ├── app.py # Main Gradio application
74
- ├── voice_cloning/ # OmniVoice integration
75
- ├── content/ # Script generation + templates
76
- ├── utils/ # Audio processing utilities
 
 
 
 
77
  ├── requirements.txt
78
  └── README.md
79
  ```
80
 
81
- ## 🤝 Credits
 
 
 
 
 
 
 
82
 
83
- Built with ❤️ for the Build Small Hackathon 2026.
 
1
  ---
2
+ title: ᐴ CritterCalm ᔔ
3
  emoji: 🐾
4
  colorFrom: green
5
  colorTo: yellow
6
  sdk: gradio
7
+ sdk_version: 6.0.0
8
  app_file: app.py
9
  pinned: false
10
  license: apache-2.0
 
17
  - build-small-hackathon
18
  - local-first
19
  - off-the-grid
20
+ - anishinaabe
21
+ - solarpunk
22
  ---
23
 
24
+ # ◈──◆──◇ ᐴ CRITTERCALM ᔔ MAANAMEWIN / VOICE-COMFORT FOR THE FOUR-LEGGEDS ◇──◆──◈
25
 
26
+ > **Maanamewin** — in Anishinaabemowin, the act of giving comfort through voice.
27
+ > Clone your voice. Calm your companion. Even across distance.
28
 
29
  CritterCalm clones your voice using state-of-the-art open-source AI, then generates
30
  personalized calming audio sessions for your pets. Dogs, cats, chickens, birds,
31
  rabbits, horses — every animal responds to their person's voice.
32
 
33
+ ## ☼ GASHKITOONAN / CAPABILITIES ◈
34
 
35
+ - **🎤 Voice Cloning** — Clone your voice from just 3-10 seconds of audio (OmniVoice 0.6B)
36
  - **🐕 Multi-Animal Support** — Species-specific calming techniques for 6 animal types
37
  - **🎯 Situation-Aware** — Tailored scripts for anxiety, storms, vet visits, and more
38
+ - **❀ Anishinaabe-Solarpunk UI** — Cedar-and-sun palette, sky-to-water gradient banner
39
+ - **☼ Custom ASP Theme** — Serif headers, sun-amber CTAs, moss-green accents
40
  - **🔌 100% Local** — No cloud APIs, no data collection, fully offline
41
  - **📚 Science-Backed** — Based on animal cognition and psychoacoustics research
42
 
43
+ ## ☼ NITAM-AABAJICHIGANAN / PREREQUISITES ◈
44
+
45
+ - Python 3.10+
46
+ - ~9GB disk for models (OmniVoice, Dolphin-X1, Kokoro)
47
+ - ~10GB RAM (CPU) or Metal/CUDA for GPU
48
+
49
+ ## ☼ AABAJITOOWINAN / INSTALLATION ◈
50
 
51
  ```bash
52
+ git clone https://github.com/nbiish/crittercalm.git
 
53
  cd crittercalm
54
  pip install -r requirements.txt
55
 
56
+ # Models auto-download on first run from Hugging Face Hub
57
  python app.py
58
  ```
59
 
60
+ Then open <http://localhost:7863/>.
61
+
62
+ ## ☼ ZHOONIYAAWICHIGEWIN / MODEL STACK ◈
63
 
64
  | Model | Size | Purpose | License |
65
  |-------|------|---------|---------|
 
69
 
70
  **Total: ~8.7B params** (well under the 32B limit)
71
 
72
+ ## ☼ MCP KINOOMAAGEWINAN / MCP TOOLS ◈
73
+
74
+ Runs with `mcp_server=True` — Streamable HTTP MCP server at `/gradio/gradio_api/mcp/`:
75
+
76
+ - `clone_voice(audio_path, transcript, ref_text)` — Clone a voice from a 10s sample
77
+ - `generate_calming_session(animal, situation, duration, voice_profile)` — Generate audio
78
+ - `play_calming(audio_id)` — Play the generated session
79
 
80
+ ## ☼ GIIZHIITAA / BADGES ◈
81
 
 
82
  - 🔌 **Off the Grid** — Fully local, no API calls
83
  - 🎯 **Well-Tuned** — Fine-tuned voice embeddings for pet-directed speech
84
  - 📓 **Field Notes** — Blog post on animal psychoacoustics + voice cloning
85
+ - 🎨 **Off-Brand** — Anishinaabe-Solarpunk theme with sky-to-sunrise palette
86
 
87
+ ## ☼ INA-WAABANDA'IWEWIN / PROJECT STRUCTURE ◈
88
 
89
  ```
90
  crittercalm/
91
+ ├── app.py # Main Gradio application
92
+ ├── voice_cloning/ # OmniVoice integration
93
+ │ └── openvoice_cloner.py
94
+ ├── content/ # Script generation + templates
95
+ │ ├── script_generator.py
96
+ │ └── templates.py
97
+ ├── utils/ # Audio processing utilities
98
+ │ └── audio_utils.py
99
  ├── requirements.txt
100
  └── README.md
101
  ```
102
 
103
+ ## ☼ GANAWENDAAGWAD / SECURITY ◈
104
+
105
+ Voice recordings, cloned profiles, and generated audio **never leave the device**.
106
+ PQC for any future API key material via the `pqc-secrets` skill (ML-KEM-768 + AES-256-GCM).
107
+
108
+ ---
109
+
110
+ ◈──◆──◇ ☼ CritterCalm v1.0 · Cedar Edition · Anishinaabe Solarpunk ◇──◆──◈
111
 
112
+ Built with ☼ for the Build Small Hackathon 2026.
projects/crittercalm/app.py CHANGED
@@ -435,56 +435,135 @@ def get_model_status() -> str:
435
  # ---------------------------------------------------------------------------
436
 
437
  CUSTOM_CSS = """
 
 
 
 
 
 
 
438
  :root {
439
- --primary: #4a7c59;
440
- --primary-light: #6b9e78;
441
- --bg: #f5f0e8;
442
- --card: #faf7f2;
443
- --text: #3d3226;
444
- --accent: #8b6914;
445
- --border: #d4c9b5;
446
- --warm: #e8c56d;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
447
  }
448
- .gradio-container {
449
- background: var(--bg) !important;
450
- font-family: 'Georgia', 'Times New Roman', serif !important;
 
 
 
451
  color: var(--text) !important;
 
 
 
452
  }
453
- h1, h2, h3 {
454
- color: var(--primary) !important;
 
455
  font-weight: 700 !important;
 
456
  }
 
457
  .tab-nav button {
458
  background: var(--card) !important;
459
  border: 1px solid var(--border) !important;
460
  color: var(--text) !important;
461
  font-size: 1.1em !important;
462
  padding: 12px 24px !important;
 
 
 
 
 
463
  }
464
  .tab-nav button.selected {
465
- background: var(--primary) !important;
466
- color: white !important;
467
- border-color: var(--primary) !important;
 
468
  }
 
469
  button.primary {
470
- background: var(--primary) !important;
471
  border: none !important;
472
- color: white !important;
473
  font-weight: 600 !important;
474
  padding: 12px 28px !important;
475
  border-radius: 8px !important;
 
 
 
476
  }
477
  button.primary:hover {
478
- background: var(--primary-light) !important;
 
 
479
  }
 
480
  .animal-emoji {
481
  font-size: 2em;
 
482
  }
483
  .model-status {
484
  background: var(--card) !important;
485
  border: 1px solid var(--border) !important;
486
  border-radius: 8px !important;
487
  padding: 16px !important;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
488
  }
489
  """
490
 
@@ -492,24 +571,26 @@ button.primary:hover {
492
  def create_app() -> gr.Blocks:
493
  """Build the CritterCalm Gradio application."""
494
  with gr.Blocks(
495
- css=CUSTOM_CSS,
496
- title="CritterCalm — AI Voice Cloning Animal Soother",
497
- theme=gr.themes.Soft(
498
- primary_hue="green",
499
- neutral_hue="stone",
500
- ),
501
  ) as app:
502
- gr.Markdown(
503
- """
504
- # 🐾 CritterCalm
505
- ### Clone your voice. Calm your pets.
506
-
507
- Ever notice how your dog settles down when you talk to them? Or how your cat
508
- purrs when they hear your voice? Animals respond to their person's voice —
509
- it's their ultimate comfort signal. **CritterCalm** clones your voice so your
510
- pets can hear you even when you're away.
511
- """
512
- )
 
 
 
 
 
 
 
513
 
514
  # Model status accordion
515
  with gr.Accordion("🔧 Model Status", open=False):
@@ -729,7 +810,9 @@ if __name__ == "__main__":
729
  app = create_app()
730
  app.launch(
731
  server_name="0.0.0.0",
732
- server_port=int(os.environ.get("PORT", 7860)),
733
  share=False,
734
  show_error=True,
 
 
735
  )
 
435
  # ---------------------------------------------------------------------------
436
 
437
  CUSTOM_CSS = """
438
+ /* =========================================================================
439
+ CritterCalm — Anishinaabe Solarpunk Theme
440
+ ----------------------------------------------------------------------------
441
+ Your pet's voice from the meadow. Sun, water, moss, and the small winds.
442
+ ========================================================================= */
443
+ @import url('https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;700&family=Inter:wght@400;500;600&family=EB+Garamond:ital,wght@0,400;0,600;1,400&display=swap');
444
+
445
  :root {
446
+ /* Anishinaabe-Solarpunk palette */
447
+ --asp-sky: #5BA4D9;
448
+ --asp-water: #1B4965;
449
+ --asp-ice: #BEE9E8;
450
+ --asp-frost: #CAF0F8;
451
+ --asp-sun: #F2A93B;
452
+ --asp-sunlight: #FFB347;
453
+ --asp-ember: #E76F51;
454
+ --asp-birch: #F5F1E8;
455
+ --asp-terra: #C8553D;
456
+ --asp-earth: #8B3A1F;
457
+ --asp-moss: #588157;
458
+ --asp-forest: #3D6A4A;
459
+ --asp-spruce: #1B4332;
460
+ --asp-night: #0F1A2C;
461
+ --asp-ash: #3A2A2A;
462
+ --asp-stone: #A89F91;
463
+
464
+ /* Legacy aliases for downstream code */
465
+ --primary: var(--asp-moss);
466
+ --primary-light: var(--asp-sunlight);
467
+ --bg: var(--asp-night);
468
+ --card: #142a3a;
469
+ --text: var(--asp-birch);
470
+ --accent: var(--asp-sun);
471
+ --border: rgba(91, 164, 217, 0.3);
472
+ --warm: var(--asp-sunlight);
473
  }
474
+
475
+ body, .gradio-container {
476
+ background:
477
+ radial-gradient(ellipse at top, rgba(91, 164, 217, 0.18) 0%, transparent 60%),
478
+ radial-gradient(ellipse at bottom, rgba(27, 73, 50, 0.25) 0%, transparent 70%),
479
+ var(--asp-night) !important;
480
  color: var(--text) !important;
481
+ font-family: 'Inter', system-ui, sans-serif !important;
482
+ max-width: 100% !important;
483
+ background-attachment: fixed;
484
  }
485
+ h1, h2, h3, h4 {
486
+ font-family: 'EB Garamond', 'Iowan Old Style', Georgia, serif !important;
487
+ color: var(--accent) !important;
488
  font-weight: 700 !important;
489
+ text-shadow: 0 0 20px rgba(242, 169, 59, 0.18);
490
  }
491
+
492
  .tab-nav button {
493
  background: var(--card) !important;
494
  border: 1px solid var(--border) !important;
495
  color: var(--text) !important;
496
  font-size: 1.1em !important;
497
  padding: 12px 24px !important;
498
+ transition: all 0.2s !important;
499
+ }
500
+ .tab-nav button:hover {
501
+ border-color: var(--accent) !important;
502
+ box-shadow: 0 0 16px rgba(242, 169, 59, 0.25);
503
  }
504
  .tab-nav button.selected {
505
+ background: linear-gradient(95deg, var(--asp-sun) 0%, var(--asp-sunlight) 100%) !important;
506
+ color: var(--asp-night) !important;
507
+ border-color: var(--accent) !important;
508
+ box-shadow: 0 0 18px rgba(242, 169, 59, 0.35);
509
  }
510
+
511
  button.primary {
512
+ background: linear-gradient(95deg, var(--asp-sun) 0%, var(--asp-sunlight) 100%) !important;
513
  border: none !important;
514
+ color: var(--asp-night) !important;
515
  font-weight: 600 !important;
516
  padding: 12px 28px !important;
517
  border-radius: 8px !important;
518
+ text-transform: uppercase;
519
+ letter-spacing: 1px;
520
+ transition: all 0.2s !important;
521
  }
522
  button.primary:hover {
523
+ background: linear-gradient(95deg, var(--asp-sunlight) 0%, var(--asp-birch) 100%) !important;
524
+ box-shadow: 0 0 20px rgba(242, 169, 59, 0.5);
525
+ transform: translateY(-1px);
526
  }
527
+
528
  .animal-emoji {
529
  font-size: 2em;
530
+ filter: drop-shadow(0 0 6px rgba(242, 169, 59, 0.4));
531
  }
532
  .model-status {
533
  background: var(--card) !important;
534
  border: 1px solid var(--border) !important;
535
  border-radius: 8px !important;
536
  padding: 16px !important;
537
+ color: var(--text) !important;
538
+ }
539
+
540
+ footer { display: none !important; }
541
+
542
+ /* === ASP Banner ====================================================== */
543
+ .asp-banner {
544
+ display: flex;
545
+ align-items: center;
546
+ justify-content: center;
547
+ gap: 0.6em;
548
+ padding: 14px 18px;
549
+ margin-bottom: 18px;
550
+ background: linear-gradient(95deg, var(--asp-sky) 0%, var(--asp-water) 100%);
551
+ color: var(--asp-birch);
552
+ border-bottom: 1px solid rgba(255, 179, 71, 0.35);
553
+ border-radius: 10px;
554
+ font-family: 'EB Garamond', Georgia, serif;
555
+ letter-spacing: 0.5px;
556
+ text-shadow: 0 1px 2px rgba(15, 26, 44, 0.45);
557
+ box-shadow: 0 4px 24px rgba(0, 0, 0, 0.35);
558
+ }
559
+ .asp-banner .syll { font-size: 1.5em; opacity: 0.9; }
560
+ .asp-banner .title { font-size: 1.1em; font-weight: 600; }
561
+ .asp-banner .glyph { color: var(--asp-sunlight); }
562
+ .asp-banner .subtitle {
563
+ color: var(--asp-frost);
564
+ font-size: 0.9em;
565
+ font-style: italic;
566
+ opacity: 0.92;
567
  }
568
  """
569
 
 
571
  def create_app() -> gr.Blocks:
572
  """Build the CritterCalm Gradio application."""
573
  with gr.Blocks(
574
+ title="CritterCalm — Maanamewin / Voice Comfort for Pets",
 
 
 
 
 
575
  ) as app:
576
+ # Anishinaabe-Solarpunk banner
577
+ gr.HTML("""
578
+ <div class="asp-banner">
579
+ <span class="syll">ᐴ</span>
580
+ <span class="glyph">☼</span>
581
+ <span class="title">CRITTERCALM</span>
582
+ <span class="glyph">❀</span>
583
+ <span class="subtitle">— Maanamewin: voice-comfort for the four-leggeds —</span>
584
+ <span class="syll">ᔔ</span>
585
+ </div>
586
+ <h3 style="text-align:center; font-style:italic; color: var(--text); margin-top:0; margin-bottom:20px; opacity: 0.85;">
587
+ Clone your voice. Calm your companion. Even across distance.
588
+ </h3>
589
+ <p style="text-align:center; max-width:680px; margin: 0 auto 24px; color: var(--text); line-height:1.6;">
590
+ Animals respond to their person&apos;s voice — it&apos;s their ultimate comfort signal.
591
+ <strong>CritterCalm</strong> clones your voice locally so your pet can hear you even when you&apos;re away.
592
+ </p>
593
+ """)
594
 
595
  # Model status accordion
596
  with gr.Accordion("🔧 Model Status", open=False):
 
810
  app = create_app()
811
  app.launch(
812
  server_name="0.0.0.0",
813
+ server_port=int(os.environ.get("PORT", "7860")),
814
  share=False,
815
  show_error=True,
816
+ mcp_server=True,
817
+ css=CUSTOM_CSS,
818
  )
projects/focusfriend/README.md CHANGED
@@ -1,10 +1,10 @@
1
  ---
2
- title: FocusFriend
3
- emoji: ✦
4
  colorFrom: indigo
5
- colorTo: amber
6
  sdk: gradio
7
- sdk_version: 5.0.0
8
  app_file: app.py
9
  pinned: false
10
  license: apache-2.0
@@ -18,30 +18,39 @@ tags:
18
  - local-first
19
  - off-the-grid
20
  - tiny-titan
 
 
21
  ---
22
 
23
- # ✦ FocusFriend — Pip, Your ASCII Wellness Companion
24
 
25
- **A tiny ASCII character who genuinely wants you to feel better.**
 
26
 
27
  Pip is a wise, dry-witted, slightly mischievous but genuinely caring wellness
28
  companion. Not a sycophantic cheerleader. Think: "your friend who's been through
29
  therapy and wants you to actually feel better, not just hear platitudes."
30
 
31
- ## ✨ Features
32
 
33
  - **💬 Chat Mode** — Talk to Pip. Real conversation, no corny platitudes.
34
  - **🎯 Focus Mode** — Pomodoro-style work sessions. Pip keeps time, stays quiet.
35
  - **🌬️ Breathe Mode** — Guided 4-7-8, box breathing, and simple deep breathing.
36
  - **🧘 Meditate Mode** — Body scan, loving-kindness, and just-sitting meditations.
37
- - **🎨 Custom UI** — Dark, cozy theme with real-time ASCII art expressions.
 
38
  - **🔌 100% Local** — No cloud APIs, no data collection, fully offline.
39
 
40
- ## 🚀 Quick Start
 
 
 
 
 
 
41
 
42
  ```bash
43
- # Clone and install
44
- git clone <this-repo>
45
  cd focusfriend
46
  pip install -r requirements.txt
47
 
@@ -50,46 +59,59 @@ huggingface-cli download unsloth/gemma-4-12b-it-GGUF \
50
  --include "gemma-4-12b-it-Q4_K_M.gguf" \
51
  --local-dir ./models
52
 
53
- # Launch
54
  python app.py
55
  ```
56
 
57
- ## 🧠 Model
 
 
58
 
59
  | Model | Size | Purpose | License |
60
  |-------|------|---------|---------|
61
- | Gemma 4 12B | 12B | Conversational AI + wellness guidance | Apache 2.0 (Gemma) |
 
 
62
 
63
- Runs on a laptop with Q4_K_M quantization (~7.7 GB).
64
 
65
- ## 🏅 Hackathon Track
 
 
 
 
66
 
67
- **Thousand Token Wood** — A delightful AI experience that wouldn't exist without AI.
68
 
69
- ### Bonus Badges
70
- - 🦙 **Tiny Titan** — Runs on ≤4B param model option available
71
- - 🎨 **Off-Brand** — Fully custom dark theme CSS + JavaScript
72
  - 🔌 **Off the Grid** — Fully local, no API calls
73
  - 📓 **Field Notes** — Blog post about AI wellness companions
 
74
 
75
- ## 🎭 Meet Pip
76
 
77
  ```
78
- _____
79
- / \
80
- | • • | ✨ Hey! I'm Pip.
81
- | ▿ | Your focus buddy.
82
- \ ~~~ /
83
- | | | |
84
- |_| |_|
85
  ```
86
 
87
  Pip has 20+ expressions that change based on the conversation context — from
88
  determined (focus mode) to peaceful (meditation) to gently concerned (checking
89
  on your wellbeing).
90
 
91
- ## 🤝 Credits
 
 
 
 
 
 
 
92
 
93
- Built with ❤️ for the Build Small Hackathon 2026.
94
  The character, personality, and experience are AI-generated — making the AI
95
  **load-bearing for the experience itself.**
 
1
  ---
2
+ title: ᐴ FocusFriend ᔔ
3
+ emoji: ☼
4
  colorFrom: indigo
5
+ colorTo: yellow
6
  sdk: gradio
7
+ sdk_version: 6.0.0
8
  app_file: app.py
9
  pinned: false
10
  license: apache-2.0
 
18
  - local-first
19
  - off-the-grid
20
  - tiny-titan
21
+ - anishinaabe
22
+ - solarpunk
23
  ---
24
 
25
+ # ◈──◆──◇ ᐴ FOCUSFRIEND ᔔ PIP, YOUR CEDAR-AND-SUN COMPANION ON THE LAKE ◇──◆──◈
26
 
27
+ > **Aaniin, amiikwens** — I am Pip, the friend of the moss and the small winds.
28
+ > Sit. Breathe. The sun is in no hurry.
29
 
30
  Pip is a wise, dry-witted, slightly mischievous but genuinely caring wellness
31
  companion. Not a sycophantic cheerleader. Think: "your friend who's been through
32
  therapy and wants you to actually feel better, not just hear platitudes."
33
 
34
+ ## ☼ GASHKITOONAN / CAPABILITIES ◈
35
 
36
  - **💬 Chat Mode** — Talk to Pip. Real conversation, no corny platitudes.
37
  - **🎯 Focus Mode** — Pomodoro-style work sessions. Pip keeps time, stays quiet.
38
  - **🌬️ Breathe Mode** — Guided 4-7-8, box breathing, and simple deep breathing.
39
  - **🧘 Meditate Mode** — Body scan, loving-kindness, and just-sitting meditations.
40
+ - **☼ Anishinaabe-Solarpunk UI** — Sky-to-sunrise palette, sun-amber gradients, biophilic motifs.
41
+ - **☘ Custom CSS Theme** — Cedar-copper shrine for Pip, water-blue surfaces, birch-cream text.
42
  - **🔌 100% Local** — No cloud APIs, no data collection, fully offline.
43
 
44
+ ## ☼ NITAM-AABAJICHIGANAN / PREREQUISITES ◈
45
+
46
+ - Python 3.10+
47
+ - ~7.7GB disk for GGUF model
48
+ - ~12GB RAM (CPU inference) or Metal/CUDA for GPU
49
+
50
+ ## ☼ AABAJITOOWINAN / INSTALLATION ◈
51
 
52
  ```bash
53
+ git clone https://github.com/nbiish/focusfriend.git
 
54
  cd focusfriend
55
  pip install -r requirements.txt
56
 
 
59
  --include "gemma-4-12b-it-Q4_K_M.gguf" \
60
  --local-dir ./models
61
 
 
62
  python app.py
63
  ```
64
 
65
+ Then open <http://localhost:7862/>.
66
+
67
+ ## ☼ ZHOONIYAAWICHIGEWIN / MODEL ◈
68
 
69
  | Model | Size | Purpose | License |
70
  |-------|------|---------|---------|
71
+ | Gemma 4 12B (Q4_K_M) | 12B params, ~7.7GB | Conversational AI + wellness guidance | Apache 2.0 (Gemma) |
72
+
73
+ ## ☼ MCP KINOOMAAGEWINAN / MCP TOOLS ◈
74
 
75
+ Runs with `mcp_server=True` — Streamable HTTP MCP server at `/gradio/gradio_api/mcp/`:
76
 
77
+ - `chat_handler(message, history, mode)` — Stream Pip's response to a message
78
+ - `set_mode(mode)` — Switch Pip's active mode (chat, focus, breathe, meditate)
79
+ - `on_focus_start(duration)` — Begin a focus session timer
80
+ - `start_breathe_session(technique)` — Begin breathing exercise
81
+ - `start_meditate_session(duration, style)` — Begin meditation
82
 
83
+ ## ☼ GIIZHIITAA / BADGES ◈
84
 
85
+ - 🎨 **Off-Brand** — Anishinaabe-Solarpunk CSS theme with sun-amber gradients
 
 
86
  - 🔌 **Off the Grid** — Fully local, no API calls
87
  - 📓 **Field Notes** — Blog post about AI wellness companions
88
+ - 🦙 **Tiny Titan** — Model option ≤4B available
89
 
90
+ ## ☼ GANAWAABANDAAN / MEET PIP ◈
91
 
92
  ```
93
+ _____
94
+ / \
95
+ | • • | ☼ Hey! I'm Pip.
96
+ | ▿ | Your focus buddy.
97
+ \ ~~~ /
98
+ | | | |
99
+ |_| |_|
100
  ```
101
 
102
  Pip has 20+ expressions that change based on the conversation context — from
103
  determined (focus mode) to peaceful (meditation) to gently concerned (checking
104
  on your wellbeing).
105
 
106
+ ## ☼ GANAWENDAAGWAD / SECURITY ◈
107
+
108
+ Standard gradio local-app practices. PQC for any future API key material via
109
+ the `pqc-secrets` skill (ML-KEM-768 + AES-256-GCM).
110
+
111
+ ---
112
+
113
+ ◈──◆──◇ ☼ FocusFriend v1.0 · Cedar Edition · Anishinaabe Solarpunk ◇──◆──◈
114
 
115
+ Built with ☼ for the Build Small Hackathon 2026.
116
  The character, personality, and experience are AI-generated — making the AI
117
  **load-bearing for the experience itself.**
projects/focusfriend/app.py CHANGED
@@ -482,69 +482,104 @@ def start_meditate_session(duration_minutes: int = 5, style: str = "body-scan")
482
  # ---------------------------------------------------------------------------
483
  # Custom CSS for Off-Brand Badge
484
  # ---------------------------------------------------------------------------
485
-
486
  FOCUSFRIEND_CSS = """
487
- /* ===== FocusFriend — Custom Off-Brand Theme ===== */
488
- @import url('https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;700&family=Inter:wght@400;500;600&display=swap');
 
 
 
 
489
 
490
  :root {
491
- --ff-bg: #1a1a2e;
492
- --ff-surface: #16213e;
493
- --ff-surface2: #0f3460;
494
- --ff-text: #e0d7c6;
495
- --ff-text-dim: #a89f91;
496
- --ff-accent: #e8b44b;
497
- --ff-accent2: #d4756b;
498
- --ff-green: #7eb77f;
499
- --ff-border: #2a2a4a;
500
- --ff-pip-bg: #0d1117;
501
- --ff-radius: 8px;
502
- --ff-font-mono: 'JetBrains Mono', 'SF Mono', 'Fira Code', monospace;
503
- --ff-font-sans: 'Inter', 'SF Pro', system-ui, sans-serif;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
504
  }
505
 
506
- /* Global overrides */
507
- .gradio-container {
508
- background: var(--ff-bg) !important;
509
- font-family: var(--ff-font-sans) !important;
 
 
510
  color: var(--ff-text) !important;
 
511
  max-width: 100% !important;
 
512
  }
513
 
514
- /* Headers */
515
  h1, h2, h3, h4 {
516
- font-family: var(--ff-font-sans) !important;
517
  color: var(--ff-accent) !important;
 
518
  }
 
519
 
520
- /* Main layout — two column */
521
  .ff-container {
522
  display: flex;
523
  gap: 24px;
524
  min-height: 80vh;
525
  }
526
 
 
527
  .ff-pip-panel {
528
  flex: 0 0 380px;
529
- background: var(--ff-pip-bg);
 
530
  border: 2px solid var(--ff-border);
531
  border-radius: var(--ff-radius);
532
  padding: 20px;
533
  display: flex;
534
  flex-direction: column;
535
  align-items: center;
 
 
 
536
  }
537
 
538
  .ff-pip-art {
539
  font-family: var(--ff-font-mono);
540
- font-size: 14px;
541
  line-height: 1.3;
542
- color: var(--ff-accent);
543
  white-space: pre;
544
  text-align: center;
545
  background: transparent;
546
  padding: 24px 16px;
547
  min-height: 240px;
 
548
  }
549
 
550
  .ff-chat-panel {
@@ -554,13 +589,15 @@ h1, h2, h3, h4 {
554
  gap: 16px;
555
  }
556
 
 
557
  .ff-mode-bar {
558
  display: flex;
559
  gap: 8px;
560
  padding: 12px;
561
- background: var(--ff-surface);
562
  border-radius: var(--ff-radius);
563
  border: 1px solid var(--ff-border);
 
564
  }
565
 
566
  .ff-mode-btn {
@@ -576,22 +613,25 @@ h1, h2, h3, h4 {
576
  }
577
 
578
  .ff-mode-btn:hover {
579
- background: var(--ff-accent) !important;
580
  color: var(--ff-bg) !important;
581
  border-color: var(--ff-accent) !important;
 
582
  }
583
 
584
  .ff-mode-btn.active {
585
- background: var(--ff-accent) !important;
586
  color: var(--ff-bg) !important;
587
  border-color: var(--ff-accent) !important;
 
588
  }
589
 
590
- /* Chat styling */
591
  .ff-chatbot {
592
  border: 1px solid var(--ff-border) !important;
593
  border-radius: var(--ff-radius) !important;
594
  background: var(--ff-surface) !important;
 
595
  }
596
 
597
  .ff-chatbot .message {
@@ -600,49 +640,57 @@ h1, h2, h3, h4 {
600
 
601
  .ff-chatbot .user {
602
  background: var(--ff-surface2) !important;
 
603
  }
604
 
605
  .ff-chatbot .bot {
606
  background: var(--ff-pip-bg) !important;
607
  border-left: 3px solid var(--ff-accent) !important;
 
608
  }
609
 
610
- /* Input area */
611
  .ff-input-row {
612
  display: flex;
613
  gap: 12px;
614
  }
615
 
616
- /* Buttons */
617
  button.primary {
618
- background: var(--ff-accent) !important;
619
- color: var(--ff-bg) !important;
620
  font-weight: 600 !important;
621
  border: none !important;
622
  border-radius: 6px !important;
623
  padding: 10px 20px !important;
624
  transition: all 0.2s !important;
 
 
 
625
  }
626
  button.primary:hover {
627
- background: var(--ff-accent2) !important;
 
 
628
  }
629
 
630
- /* Timer display */
631
  .ff-timer {
632
  font-family: var(--ff-font-mono);
633
  font-size: 3em;
634
  text-align: center;
635
- color: var(--ff-accent);
636
  padding: 20px;
 
637
  }
638
 
639
- /* Custom scrollbar */
640
  ::-webkit-scrollbar { width: 8px; }
641
- ::-webkit-scrollbar-track { background: var(--ff-bg); }
642
  ::-webkit-scrollbar-thumb { background: var(--ff-border); border-radius: 4px; }
643
- ::-webkit-scrollbar-thumb:hover { background: var(--ff-accent); }
644
 
645
- /* Animations */
646
  @keyframes pulse {
647
  0%, 100% { opacity: 1; }
648
  50% { opacity: 0.5; }
@@ -650,12 +698,44 @@ button.primary:hover {
650
  .ff-breathing {
651
  animation: pulse 4s ease-in-out infinite;
652
  }
 
 
 
 
653
 
654
- /* Gradio overrides */
655
  footer { display: none !important; }
656
  .tabs { border: none !important; }
657
- .tab-nav button { background: var(--ff-surface) !important; color: var(--ff-text-dim) !important; }
658
- .tab-nav button.selected { background: var(--ff-accent) !important; color: var(--ff-bg) !important; }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
659
  """
660
 
661
  # ---------------------------------------------------------------------------
@@ -728,25 +808,26 @@ function getBreatheDuration(technique) {
728
  def create_app() -> gr.Blocks:
729
  """Build the FocusFriend Gradio application with custom Off-Brand UI."""
730
  with gr.Blocks(
731
- css=FOCUSFRIEND_CSS,
732
- head=FOCUSFRIEND_JS,
733
  title="FocusFriend — Pip, Your ASCII Wellness Companion",
734
- theme=gr.themes.Monochrome(),
735
  ) as app:
736
  # State
737
  session_mode = gr.State("chat")
738
  session_history = gr.State([])
739
 
740
  # Header
 
741
  gr.HTML("""
742
- <div style="text-align: center; padding: 20px 0 30px;">
743
- <h1 style="font-size: 2.2em; margin: 0;">
744
- ✦ FocusFriend
745
- </h1>
746
- <p style="color: #a89f91; font-size: 1.1em; margin-top: 8px;">
747
- Pip is here. Your tiny, honest, ASCII wellness companion.
748
- </p>
749
  </div>
 
 
 
750
  """)
751
 
752
  with gr.Row(equal_height=False):
@@ -902,18 +983,19 @@ def create_app() -> gr.Blocks:
902
  outputs=[session_mode],
903
  )
904
 
905
- # Chat handler with streaming
906
  def chat_handler(message: str, history: List, mode: str):
907
  """Handle chat messages with streaming Pip responses."""
908
  if not message.strip():
909
  yield history, pip_display.value
910
  return
911
 
912
- history = history or []
913
- history.append((message, ""))
 
914
 
915
- for response, mood in chat_with_pip(message, history[:-1], mode):
916
- history[-1] = (message, response)
917
  pip_art = get_pip_expression(mood)
918
  yield history, pip_art
919
 
@@ -960,7 +1042,7 @@ def create_app() -> gr.Blocks:
960
  app.load(
961
  fn=lambda: (
962
  get_pip_expression("greeting"),
963
- "Hey! I'm Pip. Your focus buddy, breathing coach, and part-time philosopher. [mood: greeting]\n\nWhat do you need right now?"
964
  ),
965
  outputs=[pip_display, chatbot],
966
  )
@@ -975,7 +1057,10 @@ if __name__ == "__main__":
975
  app = create_app()
976
  app.launch(
977
  server_name="0.0.0.0",
978
- server_port=int(os.environ.get("PORT", 7861)),
979
  share=False,
980
  show_error=True,
 
 
 
981
  )
 
482
  # ---------------------------------------------------------------------------
483
  # Custom CSS for Off-Brand Badge
484
  # ---------------------------------------------------------------------------
 
485
  FOCUSFRIEND_CSS = """
486
+ /* =========================================================================
487
+ FocusFriend — Anishinaabe Solarpunk Theme
488
+ ----------------------------------------------------------------------------
489
+ Pip lives on the lake. Cedar-copper, sun-amber, water-blue.
490
+ ========================================================================= */
491
+ @import url('https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;700&family=Inter:wght@400;500;600&family=EB+Garamond:ital,wght@0,400;0,600;1,400&display=swap');
492
 
493
  :root {
494
+ /* Anishinaabe-Solarpunk tokens */
495
+ --asp-sky: #5BA4D9;
496
+ --asp-water: #1B4965;
497
+ --asp-ice: #BEE9E8;
498
+ --asp-frost: #CAF0F8;
499
+ --asp-sun: #F2A93B;
500
+ --asp-sunlight: #FFB347;
501
+ --asp-ember: #E76F51;
502
+ --asp-birch: #F5F1E8;
503
+ --asp-terra: #C8553D;
504
+ --asp-earth: #8B3A1F;
505
+ --asp-moss: #588157;
506
+ --asp-forest: #3D6A4A;
507
+ --asp-spruce: #1B4332;
508
+ --asp-night: #0F1A2C;
509
+ --asp-ash: #3A2E2A;
510
+ --asp-stone: #A89F91;
511
+
512
+ /* Aliases to the FocusFriend legacy names so the rest of the CSS works */
513
+ --ff-bg: var(--asp-night);
514
+ --ff-surface: #142a3a;
515
+ --ff-surface2: #1B4965;
516
+ --ff-text: var(--asp-birch);
517
+ --ff-text-dim: var(--asp-frost);
518
+ --ff-accent: var(--asp-sun);
519
+ --ff-accent2: var(--asp-ember);
520
+ --ff-green: var(--asp-moss);
521
+ --ff-border: rgba(91, 164, 217, 0.3);
522
+ --ff-pip-bg: #0a1520;
523
+ --ff-radius: 10px;
524
+ --ff-font-mono: 'JetBrains Mono', 'SF Mono', monospace;
525
+ --ff-font-sans: 'Inter', 'SF Pro', system-ui, sans-serif;
526
+ --ff-font-serif: 'EB Garamond', 'Iowan Old Style', Georgia, serif;
527
  }
528
 
529
+ /* === Background = sky over lake over forest =========================== */
530
+ body, .gradio-container {
531
+ background:
532
+ radial-gradient(ellipse at top, rgba(91, 164, 217, 0.18) 0%, transparent 60%),
533
+ radial-gradient(ellipse at bottom, rgba(27, 73, 50, 0.25) 0%, transparent 70%),
534
+ var(--asp-night) !important;
535
  color: var(--ff-text) !important;
536
+ font-family: var(--ff-font-sans) !important;
537
  max-width: 100% !important;
538
+ background-attachment: fixed;
539
  }
540
 
541
+ /* === Headers / typography ============================================ */
542
  h1, h2, h3, h4 {
543
+ font-family: var(--ff-font-serif) !important;
544
  color: var(--ff-accent) !important;
545
+ text-shadow: 0 0 20px rgba(242, 169, 59, 0.18);
546
  }
547
+ h1 { letter-spacing: 0.5px; }
548
 
549
+ /* === Layout ========================================================= */
550
  .ff-container {
551
  display: flex;
552
  gap: 24px;
553
  min-height: 80vh;
554
  }
555
 
556
+ /* === Pip Panel — Aanishinaabe cedar shrine =========================== */
557
  .ff-pip-panel {
558
  flex: 0 0 380px;
559
+ background:
560
+ linear-gradient(180deg, #0a1520 0%, #142a3a 100%);
561
  border: 2px solid var(--ff-border);
562
  border-radius: var(--ff-radius);
563
  padding: 20px;
564
  display: flex;
565
  flex-direction: column;
566
  align-items: center;
567
+ box-shadow:
568
+ inset 0 0 30px rgba(91, 164, 217, 0.08),
569
+ 0 0 30px rgba(0, 0, 0, 0.4);
570
  }
571
 
572
  .ff-pip-art {
573
  font-family: var(--ff-font-mono);
574
+ font-size: 13px;
575
  line-height: 1.3;
576
+ color: var(--asp-sun);
577
  white-space: pre;
578
  text-align: center;
579
  background: transparent;
580
  padding: 24px 16px;
581
  min-height: 240px;
582
+ text-shadow: 0 0 8px rgba(242, 169, 59, 0.25);
583
  }
584
 
585
  .ff-chat-panel {
 
589
  gap: 16px;
590
  }
591
 
592
+ /* === Mode bar ======================================================= */
593
  .ff-mode-bar {
594
  display: flex;
595
  gap: 8px;
596
  padding: 12px;
597
+ background: linear-gradient(95deg, var(--ff-surface) 0%, rgba(20, 42, 58, 0.5) 100%);
598
  border-radius: var(--ff-radius);
599
  border: 1px solid var(--ff-border);
600
+ box-shadow: 0 2px 16px rgba(0, 0, 0, 0.3);
601
  }
602
 
603
  .ff-mode-btn {
 
613
  }
614
 
615
  .ff-mode-btn:hover {
616
+ background: linear-gradient(95deg, var(--asp-sun) 0%, var(--asp-sunlight) 100%) !important;
617
  color: var(--ff-bg) !important;
618
  border-color: var(--ff-accent) !important;
619
+ box-shadow: 0 0 16px rgba(242, 169, 59, 0.3);
620
  }
621
 
622
  .ff-mode-btn.active {
623
+ background: linear-gradient(95deg, var(--asp-sun) 0%, var(--asp-sunlight) 100%) !important;
624
  color: var(--ff-bg) !important;
625
  border-color: var(--ff-accent) !important;
626
+ box-shadow: 0 0 20px rgba(242, 169, 59, 0.4);
627
  }
628
 
629
+ /* === Chat ========================================================== */
630
  .ff-chatbot {
631
  border: 1px solid var(--ff-border) !important;
632
  border-radius: var(--ff-radius) !important;
633
  background: var(--ff-surface) !important;
634
+ box-shadow: inset 0 0 30px rgba(0, 0, 0, 0.3);
635
  }
636
 
637
  .ff-chatbot .message {
 
640
 
641
  .ff-chatbot .user {
642
  background: var(--ff-surface2) !important;
643
+ border-left: 3px solid var(--asp-frost) !important;
644
  }
645
 
646
  .ff-chatbot .bot {
647
  background: var(--ff-pip-bg) !important;
648
  border-left: 3px solid var(--ff-accent) !important;
649
+ box-shadow: inset 0 0 20px rgba(242, 169, 59, 0.04);
650
  }
651
 
652
+ /* === Input row ====================================================== */
653
  .ff-input-row {
654
  display: flex;
655
  gap: 12px;
656
  }
657
 
658
+ /* === Buttons ======================================================== */
659
  button.primary {
660
+ background: linear-gradient(95deg, var(--asp-sun) 0%, var(--asp-sunlight) 100%) !important;
661
+ color: var(--asp-night) !important;
662
  font-weight: 600 !important;
663
  border: none !important;
664
  border-radius: 6px !important;
665
  padding: 10px 20px !important;
666
  transition: all 0.2s !important;
667
+ text-transform: uppercase;
668
+ letter-spacing: 1px;
669
+ font-size: 0.85em;
670
  }
671
  button.primary:hover {
672
+ background: linear-gradient(95deg, var(--asp-sunlight) 0%, var(--asp-birch) 100%) !important;
673
+ box-shadow: 0 0 20px rgba(242, 169, 59, 0.5);
674
+ transform: translateY(-1px);
675
  }
676
 
677
+ /* === Timer — solarpunk sun arc ====================================== */
678
  .ff-timer {
679
  font-family: var(--ff-font-mono);
680
  font-size: 3em;
681
  text-align: center;
682
+ color: var(--asp-sun);
683
  padding: 20px;
684
+ text-shadow: 0 0 24px rgba(242, 169, 59, 0.4);
685
  }
686
 
687
+ /* === Scrollbar ===================================================== */
688
  ::-webkit-scrollbar { width: 8px; }
689
+ ::-webkit-scrollbar-track { background: var(--asp-night); }
690
  ::-webkit-scrollbar-thumb { background: var(--ff-border); border-radius: 4px; }
691
+ ::-webkit-scrollbar-thumb:hover { background: var(--asp-sun); }
692
 
693
+ /* === Animations ==================================================== */
694
  @keyframes pulse {
695
  0%, 100% { opacity: 1; }
696
  50% { opacity: 0.5; }
 
698
  .ff-breathing {
699
  animation: pulse 4s ease-in-out infinite;
700
  }
701
+ @keyframes sunGlow {
702
+ 0%, 100% { box-shadow: 0 0 30px rgba(242, 169, 59, 0.2); }
703
+ 50% { box-shadow: 0 0 50px rgba(242, 169, 59, 0.4); }
704
+ }
705
 
706
+ /* === Gradio overrides ============================================== */
707
  footer { display: none !important; }
708
  .tabs { border: none !important; }
709
+ .tab-nav button {
710
+ background: var(--ff-surface) !important;
711
+ color: var(--ff-text-dim) !important;
712
+ }
713
+ .tab-nav button.selected {
714
+ background: linear-gradient(95deg, var(--asp-sun) 0%, var(--asp-sunlight) 100%) !important;
715
+ color: var(--asp-night) !important;
716
+ box-shadow: 0 0 16px rgba(242, 169, 59, 0.3);
717
+ }
718
+
719
+ /* === Anishinaabe-Solarpunk Banner ================================== */
720
+ .asp-banner {
721
+ display: flex;
722
+ align-items: center;
723
+ justify-content: center;
724
+ gap: 0.6em;
725
+ padding: 12px 18px;
726
+ background: linear-gradient(95deg, var(--asp-sky) 0%, var(--asp-water) 100%);
727
+ color: var(--asp-birch);
728
+ border-bottom: 1px solid rgba(255, 179, 71, 0.3);
729
+ font-family: var(--ff-font-serif);
730
+ letter-spacing: 0.5px;
731
+ text-shadow: 0 1px 2px rgba(15, 26, 44, 0.45);
732
+ margin-bottom: 16px;
733
+ border-radius: var(--ff-radius);
734
+ }
735
+ .asp-banner .syll { font-size: 1.4em; opacity: 0.9; }
736
+ .asp-banner .title { font-size: 1.05em; font-weight: 600; }
737
+ .asp-banner .glyph { color: var(--asp-sunlight); }
738
+ .asp-banner .subtitle { color: var(--asp-frost); font-size: 0.85em; font-style: italic; opacity: 0.9; }
739
  """
740
 
741
  # ---------------------------------------------------------------------------
 
808
  def create_app() -> gr.Blocks:
809
  """Build the FocusFriend Gradio application with custom Off-Brand UI."""
810
  with gr.Blocks(
 
 
811
  title="FocusFriend — Pip, Your ASCII Wellness Companion",
 
812
  ) as app:
813
  # State
814
  session_mode = gr.State("chat")
815
  session_history = gr.State([])
816
 
817
  # Header
818
+ # Header — Anishinaabe-Solarpunk banner
819
  gr.HTML("""
820
+ <div class="asp-banner">
821
+ <span class="syll">ᐴ</span>
822
+ <span class="glyph">☼</span>
823
+ <span class="title">FOCUSFRIEND</span>
824
+ <span class="glyph">☘</span>
825
+ <span class="subtitle">— Pip, your cedar-and-sun companion on the lake —</span>
826
+ <span class="syll">ᔔ</span>
827
  </div>
828
+ <h2 style="text-align:center; margin-top:-8px; margin-bottom:20px; font-style:italic; font-size:1em; color: var(--ff-text-dim);">
829
+ Aaniin, amiikwens — I am Pip, the friend of the moss and the small winds.
830
+ </h2>
831
  """)
832
 
833
  with gr.Row(equal_height=False):
 
983
  outputs=[session_mode],
984
  )
985
 
986
+ # Chat handler with streaming — Gradio 6.0 Chatbot wants dicts
987
  def chat_handler(message: str, history: List, mode: str):
988
  """Handle chat messages with streaming Pip responses."""
989
  if not message.strip():
990
  yield history, pip_display.value
991
  return
992
 
993
+ history = list(history or [])
994
+ history.append({"role": "user", "content": message})
995
+ history.append({"role": "assistant", "content": ""})
996
 
997
+ for response, mood in chat_with_pip(message, history[:-2], mode):
998
+ history[-1] = {"role": "assistant", "content": response}
999
  pip_art = get_pip_expression(mood)
1000
  yield history, pip_art
1001
 
 
1042
  app.load(
1043
  fn=lambda: (
1044
  get_pip_expression("greeting"),
1045
+ [{"role": "assistant", "content": "Hey! I\'m Pip. Your focus buddy, breathing coach, and part-time philosopher. [mood: greeting]\n\nWhat do you need right now?"}]
1046
  ),
1047
  outputs=[pip_display, chatbot],
1048
  )
 
1057
  app = create_app()
1058
  app.launch(
1059
  server_name="0.0.0.0",
1060
+ server_port=int(os.environ.get("PORT", "7861")),
1061
  share=False,
1062
  show_error=True,
1063
+ mcp_server=True,
1064
+ css=FOCUSFRIEND_CSS,
1065
+ head=FOCUSFRIEND_JS,
1066
  )
projects/tinybard/README.md CHANGED
@@ -1,8 +1,8 @@
1
  ---
2
- title: TinyBard
3
- emoji: ⚔
4
- colorFrom: green
5
- colorTo: blue
6
  sdk: gradio
7
  sdk_version: 6.0.0
8
  app_file: app.py
@@ -19,72 +19,105 @@ tags:
19
  - off-brand
20
  - off-the-grid
21
  - mcp-server
 
 
22
  ---
23
 
24
- # ⚔ TinyBard — Micro Interactive Text Adventure Generator
25
 
26
- **A ≤4B LLM generates 5-minute interactive text adventures with a retro CRT terminal UI.**
 
 
27
 
28
- TinyBard uses gr.Server (FastAPI) with a fully custom HTML/CSS/JS frontend and MCP server mode enabled.
29
- Every adventure is procedurally generated — rooms, NPCs, items, and branching narratives on the fly.
30
 
31
- ## Features
32
 
33
- - **Dynamic Adventures** — LLM generates unique story beats for every playthrough
34
- - **3 Genres** — Fantasy, Sci-Fi, Cyberpunk
35
- - **CRT Terminal UI** — Retro pixel-art aesthetic with scanlines and phosphor glow
36
- - **MCP Server** — Exposes `start_game` and `make_choice` as MCP tools for AI agent integration
37
- - **100% Local** — No cloud APIs. Runs on llama.cpp with GGUF quantized models
38
- - **Procedural Fallback** — Full game engine works even without the LLM model loaded
 
39
 
40
- ## Quick Start
 
 
 
 
 
 
41
 
42
  ```bash
43
- git clone <this-repo>
44
  cd tinybard
45
  pip install -r requirements.txt
46
 
47
- # Download model (Q4_K_M quant, ~1GB)
48
  huggingface-cli download mradermacher/VibeThinker-1.5B-GGUF \
49
  --include "VibeThinker-1.5B.Q8_0.gguf" \
50
  --local-dir ./models
51
 
52
- # Set model path
53
  export TINYBARD_MODEL_PATH=./models/VibeThinker-1.5B.Q8_0.gguf
54
 
55
- # Launch
56
  python app.py
57
  ```
58
 
59
- ## Model
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
60
 
61
  | Model | Size | Purpose | License |
62
  |-------|------|---------|---------|
63
- | VibeThinker 1.5B | 1.5B | Interactive story generation | Apache 2.0 |
64
 
65
- Fits the Tiny Titan badge (≤4B params). Runs on any laptop.
66
 
67
- ## MCP Integration
68
 
69
  TinyBard runs with `mcp_server=True`, exposing these tools:
70
 
71
- - **`start_game`** — Start a new adventure. Args: `genre` (fantasy/scifi/cyberpunk)
72
- - **`make_choice`** — Submit a player choice. Args: `choice`, `genre`, `step`, `health`, `history_json`
 
 
73
 
74
- Connect from any MCP client (Claude Desktop, Cursor, etc.) to the SSE endpoint.
75
 
76
- ## Hackathon Track
 
 
 
 
77
 
78
- **Thousand Token Wood** + **Tiny Titan** + **Llama Champion**
79
 
80
- ### Bonus Badges
81
- - **Llama Champion** — Uses llama.cpp runtime
82
- - **Tiny Titan** — Model is 1.5B (well under 4B limit)
83
- - **Off-Brand** — Fully custom gr.Server frontend (not gr.Blocks)
84
- - **Off the Grid** — Fully local, no API calls
85
- - **Field Notes** — Blog post about tiny model interactive fiction
86
 
87
- ## Credits
88
 
89
- Built for the Build Small Hackathon 2026.
90
- The AI is load-bearing: every story, choice, and narrative arc is generated live.
 
1
  ---
2
+ title: ᐴ TinyBard ᔔ
3
+ emoji: ☼
4
+ colorFrom: blue
5
+ colorTo: yellow
6
  sdk: gradio
7
  sdk_version: 6.0.0
8
  app_file: app.py
 
19
  - off-brand
20
  - off-the-grid
21
  - mcp-server
22
+ - anishinaabe
23
+ - solarpunk
24
  ---
25
 
26
+ # ◈──◆──◇ ᐴ TINYBARD ᔔ AADIZOOKAAN-AKINOOMAAGEWIN / STORY-TELLING ENGINE ◇──◆──◈
27
 
28
+ > **A ≤4B LLM fires five-minute interactive text adventures in a cedar-and-copper CRT terminal.**
29
+ >
30
+ > ᐴ The land remembers the stories. ᔔ ☼ ☘ ≈
31
 
32
+ TinyBard uses FastAPI + `mount_gradio_app` (Gradio 6.0) with a fully custom HTML/CSS/JS frontend and **MCP server mode** enabled. Every adventure is procedurally generated — rooms, NPCs, items, and branching narratives on the fly.
 
33
 
34
+ ## ◆ GASHKITOONAN / CAPABILITIES ◈
35
 
36
+ - **◇ Dynamic Adventures ◇** — LLM generates unique story beats for every playthrough
37
+ - **◇ Three Aadizookaanan / Genres ◇** — Aadizookaan (Fantasy), Ish piming (Sci-Fi), Mashkodewaazibi (Cyberpunk)
38
+ - **◇ Misko-Aki / CRT Terminal ◇** — Cedar-copper cabinet, sun-amber phosphor, frost-on-glass scanlines
39
+ - **◇ MCP Kinoomaagewinan / Tools ◇** — `start_game` and `make_choice` exposed as MCP tools
40
+ - **◇ Zhooniyaa / 100% Local ◇** — No cloud APIs. Runs on llama.cpp with GGUF quantized models
41
+ - **◇ Bmaad-ziibi / Procedural Fallback ◇** — Full engine works without the LLM model loaded
42
+ - **◇ Anishinaabe-Solarpunk ◇** — Sky-to-sunrise palette, Anishinaabe syllabic framings, biophilic motifs
43
 
44
+ ## ☼ NITAM-AABAJICHIGANAN / PREREQUISITES ◈
45
+
46
+ - Python 3.10+
47
+ - ~1GB disk for GGUF model
48
+ - ~2GB RAM (CPU inference) or Metal/CUDA for GPU
49
+
50
+ ## ◇ AABAJITOOWINAN / INSTALLATION ◈
51
 
52
  ```bash
53
+ git clone https://github.com/nbiish/tinybard.git
54
  cd tinybard
55
  pip install -r requirements.txt
56
 
57
+ # Download model (Q8_0 quant, ~1.6GB)
58
  huggingface-cli download mradermacher/VibeThinker-1.5B-GGUF \
59
  --include "VibeThinker-1.5B.Q8_0.gguf" \
60
  --local-dir ./models
61
 
 
62
  export TINYBARD_MODEL_PATH=./models/VibeThinker-1.5B.Q8_0.gguf
63
 
 
64
  python app.py
65
  ```
66
 
67
+ Then open <http://localhost:7860/>.
68
+
69
+ ## ◈ WAABANDA'IWEWIN / EXAMPLES ◇
70
+
71
+ ```text
72
+ ╭─────────────────────────────────────╮
73
+ │ ᐴ AADIZOOKAAN / FANTASY ᔔ │
74
+ ╰─────────────────────────────────────╯
75
+
76
+ You stand before the gates of the Whisperwood. The ancient trees
77
+ hum with a faint violet energy...
78
+
79
+ [ Take the golden key ] [ Drink the mossy vial ] [ Press forward ]
80
+ ```
81
+
82
+ ## ☼ NAANAAGADAWENINDIZOWIN / VERIFICATION ◈
83
+
84
+ ```bash
85
+ curl -X POST http://localhost:7860/gradio/gradio_api/call/start_game \
86
+ -H "Content-Type: application/json" \
87
+ -d '{"data":["fantasy"]}'
88
+ ```
89
+
90
+ Returns SSE event stream with `story`, `choices`, `health`, `step`, `game_over`, `history_json`.
91
+
92
+ ## ◈ MODEL ◇
93
 
94
  | Model | Size | Purpose | License |
95
  |-------|------|---------|---------|
96
+ | VibeThinker 1.5B (Q8_0) | 1.5B params, ~1.6GB | Interactive story generation | Apache 2.0 |
97
 
98
+ Fits the **Tiny Titan** badge (≤4B params). Runs on any laptop.
99
 
100
+ ## ◇ MCP KINOOMAAGEWINAN / TOOLS ◈
101
 
102
  TinyBard runs with `mcp_server=True`, exposing these tools:
103
 
104
+ - **`start_game(genre: str)`** — Start a new adventure. Genre: `fantasy` / `scifi` / `cyberpunk`
105
+ - **`make_choice(choice, genre, step, health, history_json)`** — Submit a player choice to advance the story
106
+
107
+ Connect from any MCP client (Claude Desktop, Cursor, etc.) to the SSE endpoint at `/gradio/gradio_api/mcp/`.
108
 
109
+ ## ◈ GIIZHIITAA / BADGE TARGETS ◇
110
 
111
+ - **◆ Llama Champion** — Uses llama.cpp runtime
112
+ - **◆ Tiny Titan** — Model is 1.5B (well under 4B limit)
113
+ - **◆ Off-Brand** — Fully custom FastAPI+Gradio frontend
114
+ - **◆ Off the Grid** — Fully local, no API calls
115
+ - **◆ Field Notes** — Blog post about tiny model interactive fiction
116
 
117
+ ## ☼ GANAWENDAAGWAD / SECURITY ◈
118
 
119
+ PQC standard for any future API keys via the `pqc-secrets` skill (ML-KEM-768 + AES-256-GCM). At present, the model is loaded from local GGUF — no key material in flight.
 
 
 
 
 
120
 
121
+ ---
122
 
123
+ ◈──◆──◇ ☼ TinyBard v1.0 · Cedar Edition · Anishinaabe Solarpunk ◇──◆──◈
 
projects/tinybard/app.py CHANGED
@@ -1,12 +1,16 @@
1
  #!/usr/bin/env python3
2
  """
3
- TinyBard — Micro Interactive Text Adventure Generator
4
- ======================================================
5
  Custom FastAPI app with Gradio Blocks mounted for MCP tool integration.
6
- Retro CRT terminal frontend served as static HTML.
 
 
 
7
 
8
  Targets: Thousand Token Wood + Tiny Titan + Llama Champion tracks.
9
- Badges: Llama Champion, Tiny Titan, Off-Brand (custom frontend), Off the Grid, Field Notes.
 
10
  """
11
 
12
  import os
@@ -394,8 +398,6 @@ async def homepage():
394
  if index_path.exists():
395
  return index_path.read_text()
396
  return HTMLResponse("<h1>TinyBard retro terminal under construction!</h1>")
397
-
398
-
399
  @fastapi_app.get("/api/model_status")
400
  async def model_status():
401
  """Check if the LLM is loaded."""
@@ -407,6 +409,114 @@ async def model_status():
407
  }
408
 
409
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
410
  # Mount static files
411
  fastapi_app.mount("/static", StaticFiles(directory=str(STATIC_DIR)), name="static")
412
 
 
1
  #!/usr/bin/env python3
2
  """
3
+ ᐴ TinyBard ᔔ — Aanishinaabe Mikinaak-Aki / Fire-Fly Storyteller
4
+ ==================================================================
5
  Custom FastAPI app with Gradio Blocks mounted for MCP tool integration.
6
+ Cedar-and-copper CRT terminal frontend served as static HTML.
7
+
8
+ Aesthetic: Anishinaabe Solarpunk — sky-to-sunrise palette, syllabic framings,
9
+ biophilic motifs, solarpunk hope.
10
 
11
  Targets: Thousand Token Wood + Tiny Titan + Llama Champion tracks.
12
+ Badges: Llama Champion, Tiny Titan, Off-Brand (custom frontend),
13
+ Off the Grid, Field Notes.
14
  """
15
 
16
  import os
 
398
  if index_path.exists():
399
  return index_path.read_text()
400
  return HTMLResponse("<h1>TinyBard retro terminal under construction!</h1>")
 
 
401
  @fastapi_app.get("/api/model_status")
402
  async def model_status():
403
  """Check if the LLM is loaded."""
 
409
  }
410
 
411
 
412
+ # ---------------------------------------------------------------------------
413
+ # Game Logic — exposed as both FastAPI (clean JSON) and Gradio (MCP)
414
+ # ---------------------------------------------------------------------------
415
+ def _run_turn(choice: str, genre: str, step: int, health: int, history: List[Dict]) -> dict:
416
+ """Single source of truth for one adventure turn.
417
+
418
+ Returns a dict the frontend can consume directly. Used by both the
419
+ FastAPI /api/game/* endpoints and the Gradio MCP tools.
420
+ """
421
+ llm = get_llm()
422
+
423
+ if step == 0:
424
+ # New game
425
+ if not llm:
426
+ return generate_procedural_step(genre, 0, 100)
427
+ instruction = "Narrate the beginning of the adventure. What happens first? Do not offer choices yet."
428
+ story = generate_llm_story(format_prompt(genre, [], instruction))
429
+ if not story:
430
+ return generate_procedural_step(genre, 0, 100)
431
+ history = [{"role": "narrator", "text": story}]
432
+ choices_instruction = (
433
+ "Provide exactly 3 short, distinct choices for the player. "
434
+ "Format: 1. [choice 1] | 2. [choice 2] | 3. [choice 3]"
435
+ )
436
+ choices_text = generate_llm_story(format_prompt(genre, history, choices_instruction), max_tokens=60)
437
+ choices = _parse_choices(choices_text)
438
+ if len(choices) < 2:
439
+ choices = ["Explore the area", "Check your equipment", "Proceed carefully"]
440
+ return {
441
+ "story": story, "choices": choices[:3], "health": 100,
442
+ "step": 1, "game_over": False, "history": history,
443
+ }
444
+
445
+ # Subsequent turn
446
+ if not llm:
447
+ return generate_procedural_step(genre, step, health, choice)
448
+
449
+ history.append({"role": "player", "text": choice})
450
+ health_delta = random.choice([-15, 0, 10])
451
+ new_health = max(0, min(100, health + health_delta))
452
+
453
+ if new_health <= 0:
454
+ instruction = "The player has run out of health. Narrate a quick, dramatic end. Game Over."
455
+ story = generate_llm_story(format_prompt(genre, history, instruction))
456
+ return {
457
+ "story": story or "Your strength fails. The adventure ends in darkness.",
458
+ "choices": [], "health": 0, "step": step + 1, "game_over": True,
459
+ "history": history,
460
+ }
461
+
462
+ if step >= 4:
463
+ instruction = "Narrate the final glorious victory. The adventure ends in success."
464
+ story = generate_llm_story(format_prompt(genre, history, instruction))
465
+ return {
466
+ "story": story or "You have achieved your goal! You are victorious!",
467
+ "choices": [], "health": new_health, "step": step + 1, "game_over": True,
468
+ "history": history,
469
+ }
470
+
471
+ instruction = "Narrate what happens next as a result of the player's choice."
472
+ story = generate_llm_story(format_prompt(genre, history, instruction))
473
+ if not story:
474
+ return generate_procedural_step(genre, step, health, choice)
475
+ history.append({"role": "narrator", "text": story})
476
+
477
+ choices_instruction = (
478
+ "Provide exactly 3 short, distinct choices. "
479
+ "Format: 1. [choice 1] | 2. [choice 2] | 3. [choice 3]"
480
+ )
481
+ choices_text = generate_llm_story(format_prompt(genre, history, choices_instruction), max_tokens=60)
482
+ choices = _parse_choices(choices_text)
483
+ if len(choices) < 2:
484
+ choices = ["Move forward", "Look around", "Rest a moment"]
485
+ return {
486
+ "story": story, "choices": choices[:3], "health": new_health,
487
+ "step": step + 1, "game_over": False, "history": history,
488
+ }
489
+
490
+
491
+ @fastapi_app.post("/api/game/start")
492
+ async def game_start(payload: dict):
493
+ """Start a new adventure. Returns clean JSON.
494
+
495
+ Body: {"genre": "fantasy|scifi|cyberpunk"}
496
+ """
497
+ genre = (payload.get("genre") or "fantasy").lower()
498
+ if genre not in ["fantasy", "scifi", "cyberpunk"]:
499
+ genre = "fantasy"
500
+ return _run_turn(choice="", genre=genre, step=0, health=100, history=[])
501
+
502
+
503
+ @fastapi_app.post("/api/game/choice")
504
+ async def game_choice(payload: dict):
505
+ """Submit a player choice. Returns clean JSON.
506
+
507
+ Body: {
508
+ "choice": str, "genre": str, "step": int, "health": int,
509
+ "history": [{"role": ..., "text": ...}, ...]
510
+ }
511
+ """
512
+ return _run_turn(
513
+ choice=payload.get("choice", ""),
514
+ genre=payload.get("genre", "fantasy"),
515
+ step=int(payload.get("step", 1)),
516
+ health=int(payload.get("health", 100)),
517
+ history=payload.get("history", []),
518
+ )
519
+
520
  # Mount static files
521
  fastapi_app.mount("/static", StaticFiles(directory=str(STATIC_DIR)), name="static")
522
 
projects/tinybard/static/index.html CHANGED
@@ -3,63 +3,71 @@
3
  <head>
4
  <meta charset="UTF-8">
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>TinyBard — Micro Text Adventure</title>
7
  <link rel="stylesheet" href="/static/style.css">
8
  </head>
9
  <body>
 
 
 
 
 
 
 
 
10
  <div class="crt-container">
11
  <div class="crt-screen" id="screen">
12
  <div class="scanlines"></div>
13
  <div class="vignette"></div>
14
-
15
  <div class="terminal" id="terminal">
16
  <div class="terminal-header">
17
- <span class="prompt">TINYBARD v1.0</span>
18
- <span class="status" id="health-bar">HEALTH: <span id="health-val">100</span></span>
19
  </div>
20
-
21
  <div class="terminal-body" id="output">
22
  <div class="boot-sequence" id="boot">
23
- <span class="line">> INITIALIZING NEURAL INTERFACE...</span>
24
- <span class="line">> LOADING NARRATIVE ENGINE...</span>
25
- <span class="line">> CONNECTING TO GRADIO SERVER...</span>
26
- <span class="line success">> CONNECTION ESTABLISHED</span>
27
- <span class="line">> SELECT GENRE TO BEGIN</span>
28
  </div>
29
  </div>
30
-
31
  <div class="genre-selector" id="genre-selector">
32
  <div class="genre-option" data-genre="fantasy">
33
- <span class="icon">⚔</span> FANTASY
34
  </div>
35
  <div class="genre-option" data-genre="scifi">
36
- <span class="icon">🚀</span> SCI-FI
37
  </div>
38
  <div class="genre-option" data-genre="cyberpunk">
39
- <span class="icon">🌆</span> CYBERPUNK
40
  </div>
41
  </div>
42
-
43
  <div class="choices-container" id="choices" style="display: none;">
44
  <!-- Choices injected here -->
45
  </div>
46
-
47
  <div class="input-line" id="input-line" style="display: none;">
48
- <span class="prompt-char">></span>
49
  <input type="text" id="cmd-input" autocomplete="off" spellcheck="false" />
50
- <span class="cursor" id="cursor">_</span>
51
  </div>
52
-
53
  <div class="terminal-footer">
54
- <span>TinyBard | gr.Server + MCP | Llama.cpp</span>
55
- <span id="model-status">MODEL: LOADING...</span>
56
  </div>
57
  </div>
58
  </div>
59
-
60
  <div class="crt-reflection"></div>
61
  </div>
62
-
63
  <script type="module" src="/static/main.js"></script>
64
  </body>
65
- </html>
 
3
  <head>
4
  <meta charset="UTF-8">
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>ᐴ TinyBard ᔔ — Aanishinaabe Mikinaak-Aki</title>
7
  <link rel="stylesheet" href="/static/style.css">
8
  </head>
9
  <body>
10
+ <header class="asp-banner">
11
+ <span class="syll">ᐴ</span>
12
+ <span class="glyph">☼</span>
13
+ <span class="title">TINYBARD</span>
14
+ <span class="glyph">☘</span>
15
+ <span class="subtitle">— a fire-fly storyteller in cedar and copper —</span>
16
+ <span class="syll">ᔔ</span>
17
+ </header>
18
  <div class="crt-container">
19
  <div class="crt-screen" id="screen">
20
  <div class="scanlines"></div>
21
  <div class="vignette"></div>
22
+
23
  <div class="terminal" id="terminal">
24
  <div class="terminal-header">
25
+ <span class="prompt">ᐴ TINYBARD v1.0 ᔔ · GIIZHI-AADIZOKED</span>
26
+ <span class="status" id="health-bar">NOOSISKAAZOWIN: <span id="health-val">100</span></span>
27
  </div>
28
+
29
  <div class="terminal-body" id="output">
30
  <div class="boot-sequence" id="boot">
31
+ <span class="line">☼ &gt; INITIAINDIZOWIN / INITIALIZING NEURAL INTERFACE...</span>
32
+ <span class="line">☼ &gt; AABAJICHIGANAN / LOADING NARRATIVE ENGINE...</span>
33
+ <span class="line">☼ &gt; GIIWENAABIK / CONNECTING TO GRADIO SERVER...</span>
34
+ <span class="line success">☼ &gt; MII-GIIWETA / CONNECTION ESTABLISHED</span>
35
+ <span class="line">ᐴ &gt; INAABANDA'IWIN / SELECT GENRE TO BEGIN ᔔ</span>
36
  </div>
37
  </div>
38
+
39
  <div class="genre-selector" id="genre-selector">
40
  <div class="genre-option" data-genre="fantasy">
41
+ <span class="icon">☼</span> AADIZOOKAAN / FANTASY
42
  </div>
43
  <div class="genre-option" data-genre="scifi">
44
+ <span class="icon">◈</span> ISHPIMING / SCI-FI
45
  </div>
46
  <div class="genre-option" data-genre="cyberpunk">
47
+ <span class="icon">◆</span> MASHKODEWAAZIBI / CYBERPUNK
48
  </div>
49
  </div>
50
+
51
  <div class="choices-container" id="choices" style="display: none;">
52
  <!-- Choices injected here -->
53
  </div>
54
+
55
  <div class="input-line" id="input-line" style="display: none;">
56
+ <span class="prompt-char">ᐴ&gt;</span>
57
  <input type="text" id="cmd-input" autocomplete="off" spellcheck="false" />
58
+ <span class="cursor">_</span>
59
  </div>
60
+
61
  <div class="terminal-footer">
62
+ <span>ᐴ TinyBard · FastAPI + Gradio + MCP · llama.cpp ᔔ</span>
63
+ <span id="model-status">☘ MODEL: AABAJICHIGE / LOADING...</span>
64
  </div>
65
  </div>
66
  </div>
67
+
68
  <div class="crt-reflection"></div>
69
  </div>
70
+
71
  <script type="module" src="/static/main.js"></script>
72
  </body>
73
+ </html>
projects/tinybard/static/main.js CHANGED
@@ -30,44 +30,40 @@ const modelStatus = document.getElementById("model-status");
30
  const boot = document.getElementById("boot");
31
 
32
  // ---------------------------------------------------------------------------
33
- // Gradio Client
34
  // ---------------------------------------------------------------------------
35
- let gradioClient = null;
36
- const GRADIO_PATH = "/gradio";
37
-
38
- async function initClient() {
39
  try {
40
- const { Client } = await import(
41
- "https://cdn.jsdelivr.net/npm/@gradio/client/dist/index.min.js"
42
- );
43
- gradioClient = await Client.connect(GRADIO_CLIENT_URL + GRADIO_PATH);
44
- modelStatus.textContent = "MODEL: CONNECTED";
45
- modelStatus.style.color = "#00ff41";
46
- } catch (e) {
47
- console.warn("Gradio client init failed, using fetch fallback:", e);
48
- gradioClient = null;
49
- modelStatus.textContent = "MODEL: FETCH MODE";
50
- modelStatus.style.color = "#ffb000";
 
51
  }
52
  }
53
-
54
  async function apiCall(endpoint, payload) {
55
- if (gradioClient) {
56
- try {
57
- const result = await gradioClient.predict(endpoint, payload);
58
- return result.data;
59
- } catch (e) {
60
- console.warn("Gradio client call failed, falling back to fetch:", e);
61
- }
62
- }
63
- // Fallback: direct fetch to gradio API
64
- const resp = await fetch(`${GRADIO_CLIENT_URL}${GRADIO_PATH}/api/${endpoint}`, {
65
  method: "POST",
66
  headers: { "Content-Type": "application/json" },
67
- body: JSON.stringify({ data: Object.values(payload) })
68
  });
69
- const json = await resp.json();
70
- return json.data;
 
 
71
  }
72
 
73
  // ---------------------------------------------------------------------------
@@ -239,25 +235,8 @@ cmdInput.addEventListener("keydown", (e) => {
239
  }
240
  });
241
 
242
- // ---------------------------------------------------------------------------
243
  // Boot
244
  // ---------------------------------------------------------------------------
245
  (async () => {
246
- await initClient();
247
-
248
- // Check model status
249
- try {
250
- const resp = await fetch(`${GRADIO_CLIENT_URL}/api/model_status`);
251
- const status = await resp.json();
252
- if (status.available) {
253
- modelStatus.textContent = "MODEL: READY";
254
- modelStatus.style.color = "#00ff41";
255
- } else {
256
- modelStatus.textContent = "MODEL: FALLBACK";
257
- modelStatus.style.color = "#ffb000";
258
- }
259
- } catch {
260
- modelStatus.textContent = "MODEL: UNKNOWN";
261
- modelStatus.style.color = "#666";
262
- }
263
  })();
 
30
  const boot = document.getElementById("boot");
31
 
32
  // ---------------------------------------------------------------------------
33
+ // API client — uses FastAPI clean-JSON endpoints
34
  // ---------------------------------------------------------------------------
35
+ async function checkModelStatus() {
 
 
 
36
  try {
37
+ const resp = await fetch(`${GRADIO_CLIENT_URL}/api/model_status`);
38
+ if (!resp.ok) return;
39
+ const status = await resp.json();
40
+ if (status.available) {
41
+ modelStatus.textContent = "☘ MODEL: MII-GIIWETA / READY";
42
+ modelStatus.style.color = "var(--asp-sun)";
43
+ } else {
44
+ modelStatus.textContent = "☘ MODEL: GIIZHIK-WIIKI / FALLBACK";
45
+ modelStatus.style.color = "var(--asp-frost)";
46
+ }
47
+ } catch {
48
+ modelStatus.textContent = "☘ MODEL: ?";
49
  }
50
  }
 
51
  async function apiCall(endpoint, payload) {
52
+ // Use the FastAPI clean-JSON endpoints (returns a dict directly).
53
+ // /api/game/start -> start_game
54
+ // /api/game/choice -> make_choice
55
+ const path = endpoint === "/start_game"
56
+ ? "/api/game/start"
57
+ : "/api/game/choice";
58
+ const resp = await fetch(`${GRADIO_CLIENT_URL}${path}`, {
 
 
 
59
  method: "POST",
60
  headers: { "Content-Type": "application/json" },
61
+ body: JSON.stringify(payload),
62
  });
63
+ if (!resp.ok) {
64
+ throw new Error(`HTTP ${resp.status}`);
65
+ }
66
+ return await resp.json();
67
  }
68
 
69
  // ---------------------------------------------------------------------------
 
235
  }
236
  });
237
 
 
238
  // Boot
239
  // ---------------------------------------------------------------------------
240
  (async () => {
241
+ await checkModelStatus();
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
242
  })();
projects/tinybard/static/style.css CHANGED
@@ -1,15 +1,43 @@
1
- /* TinyBard CRT Terminal Theme */
2
-
 
 
 
 
 
 
 
 
3
  :root {
4
- --green: #00ff41;
5
- --green-dim: #00aa2a;
6
- --green-dark: #004d13;
7
- --green-glow: rgba(0, 255, 65, 0.15);
8
- --amber: #ffb000;
9
- --red: #ff0040;
10
- --bg: #0a0a0a;
11
- --terminal-bg: #0d1117;
12
- --scanline-opacity: 0.03;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
13
  }
14
 
15
  * { margin: 0; padding: 0; box-sizing: border-box; }
@@ -20,43 +48,99 @@
20
  }
21
 
22
  body {
23
- background: var(--bg);
 
 
 
24
  font-family: 'MonoFallback', monospace;
25
- color: var(--green);
26
  min-height: 100vh;
27
  display: flex;
 
28
  align-items: center;
29
  justify-content: center;
30
- overflow: hidden;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
31
  }
32
 
33
- /* CRT Monitor Container */
34
  .crt-container {
35
  width: 90vw;
36
  max-width: 900px;
37
- height: 85vh;
38
- max-height: 700px;
39
  position: relative;
40
- background: #1a1a2e;
41
- border-radius: 30px;
42
- padding: 25px;
 
43
  box-shadow:
44
- 0 0 80px rgba(0, 255, 65, 0.08),
45
  inset 0 0 60px rgba(0, 0, 0, 0.5),
46
  0 20px 60px rgba(0, 0, 0, 0.8);
47
  }
48
 
 
 
 
 
 
 
 
 
 
 
 
 
 
49
  .crt-screen {
50
  width: 100%;
51
  height: 100%;
52
  background: var(--terminal-bg);
53
- border-radius: 15px;
54
  overflow: hidden;
55
  position: relative;
56
- border: 2px solid #222;
 
 
 
57
  }
58
 
59
- /* Scanlines overlay */
60
  .scanlines {
61
  position: absolute;
62
  top: 0; left: 0; right: 0; bottom: 0;
@@ -64,23 +148,28 @@ body {
64
  0deg,
65
  transparent,
66
  transparent 2px,
67
- rgba(0, 0, 0, var(--scanline-opacity)) 2px,
68
- rgba(0, 0, 0, var(--scanline-opacity)) 4px
69
  );
70
  pointer-events: none;
71
  z-index: 10;
72
  }
73
 
74
- /* Vignette effect */
75
  .vignette {
76
  position: absolute;
77
  top: 0; left: 0; right: 0; bottom: 0;
78
- background: radial-gradient(ellipse at center, transparent 60%, rgba(0,0,0,0.4) 100%);
 
 
 
 
 
79
  pointer-events: none;
80
  z-index: 10;
81
  }
82
 
83
- /* CRT reflection/glare */
84
  .crt-reflection {
85
  position: absolute;
86
  top: 5%;
@@ -89,7 +178,7 @@ body {
89
  height: 30%;
90
  background: linear-gradient(
91
  135deg,
92
- rgba(255, 255, 255, 0.03) 0%,
93
  transparent 100%
94
  );
95
  pointer-events: none;
@@ -97,7 +186,7 @@ body {
97
  border-radius: 50%;
98
  }
99
 
100
- /* Terminal Layout */
101
  .terminal {
102
  width: 100%;
103
  height: 100%;
@@ -106,6 +195,7 @@ body {
106
  padding: 15px 20px;
107
  position: relative;
108
  z-index: 5;
 
109
  }
110
 
111
  .terminal-header {
@@ -113,118 +203,130 @@ body {
113
  justify-content: space-between;
114
  align-items: center;
115
  padding-bottom: 10px;
116
- border-bottom: 1px solid var(--green-dark);
117
  margin-bottom: 10px;
118
  font-size: 0.75rem;
119
- color: var(--green-dim);
120
  text-transform: uppercase;
121
  letter-spacing: 2px;
 
122
  }
 
 
 
 
 
123
 
124
- .terminal-header .status { color: var(--amber); }
125
- #health-val { color: var(--green); font-weight: bold; }
126
-
127
- /* Terminal output area */
128
  .terminal-body {
129
  flex: 1;
130
  overflow-y: auto;
131
  overflow-x: hidden;
132
  padding-right: 10px;
133
- font-size: 0.85rem;
134
- line-height: 1.6;
135
- text-shadow: 0 0 5px var(--green-glow);
136
  scroll-behavior: smooth;
137
  }
138
-
139
  .terminal-body::-webkit-scrollbar { width: 6px; }
140
  .terminal-body::-webkit-scrollbar-track { background: transparent; }
141
  .terminal-body::-webkit-scrollbar-thumb {
142
- background: var(--green-dark);
143
  border-radius: 3px;
144
  }
145
 
146
- /* Text styles */
147
  .line {
148
  display: block;
149
  margin-bottom: 3px;
150
  opacity: 0;
151
  animation: typeIn 0.5s forwards;
152
  }
153
- .line.success { color: var(--green); }
154
- .line.error { color: var(--red); }
155
- .line.amber { color: var(--amber); }
156
 
157
  .story-text {
158
  display: block;
159
- margin: 12px 0;
160
- padding: 10px 15px;
161
- border-left: 2px solid var(--green-dim);
162
- background: rgba(0, 255, 65, 0.03);
 
163
  white-space: pre-wrap;
 
164
  animation: fadeSlideIn 0.6s ease-out;
 
165
  }
166
 
167
  .narrator-prefix {
168
- color: var(--amber);
169
  font-weight: bold;
 
170
  }
171
 
172
  .player-action {
173
  display: block;
174
- color: var(--green-dim);
175
  margin: 5px 0;
176
  font-style: italic;
 
 
177
  }
178
 
179
  .game-over-win {
180
- color: var(--green);
181
- text-shadow: 0 0 20px var(--green);
182
- font-size: 1.1rem;
183
  text-align: center;
184
  padding: 20px;
185
  animation: pulse 2s infinite;
 
186
  }
187
 
188
  .game-over-lose {
189
- color: var(--red);
190
- text-shadow: 0 0 20px var(--red);
191
- font-size: 1.1rem;
192
  text-align: center;
193
  padding: 20px;
194
  animation: pulse 2s infinite;
 
195
  }
196
 
197
- /* Genre selector */
198
  .genre-selector {
199
  display: flex;
200
  gap: 15px;
201
  padding: 15px 0;
202
  justify-content: center;
 
203
  }
204
 
205
  .genre-option {
206
  padding: 12px 25px;
207
- border: 1px solid var(--green-dark);
208
  border-radius: 4px;
209
  cursor: pointer;
210
  transition: all 0.2s;
211
  text-transform: uppercase;
212
- letter-spacing: 1px;
213
  font-size: 0.8rem;
214
- color: var(--green-dim);
 
215
  }
216
 
217
  .genre-option:hover {
218
- background: var(--green-dark);
219
- color: var(--green);
220
- border-color: var(--green);
221
- text-shadow: 0 0 10px var(--green);
222
- box-shadow: 0 0 15px rgba(0, 255, 65, 0.2);
 
223
  }
224
 
225
- .genre-option .icon { margin-right: 8px; font-size: 1rem; }
226
 
227
- /* Choice buttons */
228
  .choices-container {
229
  display: flex;
230
  flex-direction: column;
@@ -235,160 +337,164 @@ body {
235
  .choice-btn {
236
  display: block;
237
  padding: 10px 15px;
238
- border: 1px solid var(--green-dark);
239
  border-radius: 3px;
240
  background: transparent;
241
- color: var(--green-dim);
242
  font-family: 'MonoFallback', monospace;
243
- font-size: 0.8rem;
244
  cursor: pointer;
245
  text-align: left;
246
  transition: all 0.15s;
247
- text-shadow: 0 0 3px var(--green-glow);
248
  }
249
 
250
  .choice-btn:hover {
251
- background: rgba(0, 255, 65, 0.08);
252
- border-color: var(--green);
253
- color: var(--green);
254
  padding-left: 25px;
 
255
  }
256
 
257
  .choice-btn::before {
258
- content: '> ';
259
- color: var(--amber);
 
260
  }
261
 
262
- /* Input line */
263
  .input-line {
264
  display: flex;
265
  align-items: center;
266
  padding: 10px 0 5px;
267
- border-top: 1px solid var(--green-dark);
268
  margin-top: 5px;
269
  }
270
 
271
  .prompt-char {
272
- color: var(--amber);
273
  margin-right: 8px;
274
  font-weight: bold;
 
275
  }
276
 
277
  #cmd-input {
278
  flex: 1;
279
  background: transparent;
280
  border: none;
281
- color: var(--green);
282
  font-family: 'MonoFallback', monospace;
283
- font-size: 0.85rem;
284
  outline: none;
285
  caret-color: transparent;
286
  }
287
 
288
  .cursor {
289
- color: var(--green);
 
290
  animation: blink 0.8s step-end infinite;
291
  }
292
 
293
- /* Terminal footer */
294
  .terminal-footer {
295
  display: flex;
296
  justify-content: space-between;
297
  padding-top: 8px;
298
- border-top: 1px solid #1a1a2e;
299
  margin-top: 8px;
300
  font-size: 0.65rem;
301
- color: #444;
302
- letter-spacing: 1px;
303
  }
304
 
305
- #model-status { color: var(--green-dark); }
306
 
307
- /* Health bar visual */
308
  .health-bar-visual {
309
  width: 100%;
310
  height: 4px;
311
- background: #1a1a2e;
312
  border-radius: 2px;
313
  margin-top: 5px;
314
  overflow: hidden;
 
315
  }
316
 
317
  .health-bar-fill {
318
  height: 100%;
319
- background: var(--green);
320
  transition: width 0.5s ease, background-color 0.5s;
321
  border-radius: 2px;
 
322
  }
323
 
324
- .health-bar-fill.low { background: var(--red); }
325
- .health-bar-fill.mid { background: var(--amber); }
326
 
327
- /* New game button */
328
  .new-game-btn {
329
  display: inline-block;
330
- padding: 8px 20px;
331
- border: 1px solid var(--green-dark);
332
  border-radius: 3px;
333
  background: transparent;
334
- color: var(--green-dim);
335
  font-family: 'MonoFallback', monospace;
336
- font-size: 0.75rem;
337
  cursor: pointer;
338
  text-transform: uppercase;
339
- letter-spacing: 1px;
340
  margin-top: 10px;
341
  transition: all 0.2s;
342
  }
343
 
344
  .new-game-btn:hover {
345
- background: var(--green-dark);
346
- color: var(--green);
347
- border-color: var(--green);
 
348
  }
349
 
350
- /* Animations */
351
  @keyframes typeIn {
352
  from { opacity: 0; transform: translateY(5px); }
353
  to { opacity: 1; transform: translateY(0); }
354
  }
355
-
356
  @keyframes fadeSlideIn {
357
  from { opacity: 0; transform: translateX(-10px); }
358
  to { opacity: 1; transform: translateX(0); }
359
  }
360
-
361
  @keyframes blink {
362
  50% { opacity: 0; }
363
  }
364
-
365
  @keyframes pulse {
366
  0%, 100% { opacity: 1; }
367
- 50% { opacity: 0.6; }
368
  }
369
 
370
- /* Flicker effect on load */
371
  .crt-screen {
372
- animation: crtOn 0.5s ease-out;
373
  }
374
-
375
- @keyframes crtOn {
376
- 0% { opacity: 0; transform: scaleY(0.01); }
377
- 40% { opacity: 1; transform: scaleY(0.01); }
378
- 60% { transform: scaleY(1.05); }
379
- 80% { transform: scaleY(0.98); }
380
- 100% { transform: scaleY(1); }
381
  }
382
 
383
- /* Mobile responsive */
384
  @media (max-width: 600px) {
385
  .crt-container {
386
  width: 95vw;
387
- height: 90vh;
388
  padding: 12px;
389
- border-radius: 15px;
390
  }
391
  .genre-selector { flex-direction: column; gap: 8px; }
392
  .genre-option { text-align: center; }
393
- .terminal-body { font-size: 0.75rem; }
 
394
  }
 
1
+ /* =========================================================================
2
+ TinyBard — Anishinaabe Solarpunk CRT Terminal
3
+ ----------------------------------------------------------------------------
4
+ A retro CRT terminal reinterpreted through Anishinaabe + Solarpunk lenses.
5
+ Phosphor glow becomes "fire-fly light"; scanlines become "birch-bark rings";
6
+ the cabinet's amber becomes rising sun; the screen is the lake (Gichigami)
7
+ at dusk, framed in cedar and copper.
8
+ ========================================================================= */
9
+
10
+ /* === ANISHINAABE-SOLARPUNK DESIGN TOKENS ============================== */
11
  :root {
12
+ /* Solarpunk palette */
13
+ --asp-sky: #5BA4D9;
14
+ --asp-water: #1B4965;
15
+ --asp-ice: #BEE9E8;
16
+ --asp-frost: #CAF0F8;
17
+ --asp-sun: #F2A93B;
18
+ --asp-sunlight: #FFB347;
19
+ --asp-ember: #E76F51;
20
+ --asp-birch: #F5F1E8;
21
+ --asp-terra: #C8553D;
22
+ --asp-earth: #8B3A1F;
23
+ --asp-moss: #588157;
24
+ --asp-forest: #3D6A4A;
25
+ --asp-spruce: #1B4332;
26
+ --asp-night: #0F1A2C;
27
+ --asp-ash: #3A2E2A;
28
+ --asp-stone: #A89F91;
29
+ --asp-ink: #1A1F2E;
30
+
31
+ /* CRT / terminal legacy (re-anchored to solarpunk palette) */
32
+ --green: var(--asp-sun); /* phosphor -> rising sun amber */
33
+ --green-dim: #C97F1E; /* dim sun */
34
+ --green-dark: #5E3A0E; /* cedar-bark */
35
+ --green-glow: rgba(242, 169, 59, 0.18);
36
+ --amber: var(--asp-sunlight);
37
+ --red: var(--asp-ember);
38
+ --bg: var(--asp-night);
39
+ --terminal-bg: linear-gradient(160deg, #0F1A2C 0%, #1A2A1F 100%);
40
+ --scanline-opacity: 0.04;
41
  }
42
 
43
  * { margin: 0; padding: 0; box-sizing: border-box; }
 
48
  }
49
 
50
  body {
51
+ background:
52
+ radial-gradient(ellipse at top, #1B4965 0%, transparent 60%),
53
+ radial-gradient(ellipse at bottom right, #1B4332 0%, transparent 70%),
54
+ var(--bg);
55
  font-family: 'MonoFallback', monospace;
56
+ color: var(--asp-birch);
57
  min-height: 100vh;
58
  display: flex;
59
+ flex-direction: column;
60
  align-items: center;
61
  justify-content: center;
62
+ overflow-x: hidden;
63
+ overflow-y: auto;
64
+ }
65
+
66
+ /* === ANISHINAABE-SOLARPUNK BANNER ===================================== */
67
+ .asp-banner {
68
+ width: 90vw;
69
+ max-width: 900px;
70
+ display: flex;
71
+ align-items: center;
72
+ justify-content: center;
73
+ gap: 0.7em;
74
+ padding: 12px 18px;
75
+ margin-top: 18px;
76
+ background: linear-gradient(95deg, var(--asp-sky) 0%, var(--asp-water) 100%);
77
+ color: var(--asp-birch);
78
+ border: 1px solid rgba(255, 179, 71, 0.3);
79
+ border-radius: 10px 10px 0 0;
80
+ font-family: Georgia, 'Iowan Old Style', serif;
81
+ letter-spacing: 0.5px;
82
+ text-shadow: 0 1px 2px rgba(15, 26, 44, 0.45);
83
+ box-shadow: 0 4px 24px rgba(0, 0, 0, 0.4);
84
+ }
85
+ .asp-banner .syll { font-size: 1.5em; opacity: 0.9; }
86
+ .asp-banner .title { font-size: 1.05em; font-weight: 600; }
87
+ .asp-banner .glyph {
88
+ display: inline-block;
89
+ transform: translateY(-1px);
90
+ font-size: 1.15em;
91
+ color: var(--asp-sunlight);
92
+ }
93
+ .asp-banner .subtitle {
94
+ color: var(--asp-frost);
95
+ font-size: 0.85em;
96
+ font-style: italic;
97
+ opacity: 0.85;
98
  }
99
 
100
+ /* === CRT MONITOR (cedar-copper cabinet) ================================ */
101
  .crt-container {
102
  width: 90vw;
103
  max-width: 900px;
104
+ height: 75vh;
105
+ max-height: 660px;
106
  position: relative;
107
+ background:
108
+ linear-gradient(180deg, #8B3A1F 0%, #5E2710 100%);
109
+ border-radius: 18px 18px 30px 30px;
110
+ padding: 22px;
111
  box-shadow:
112
+ 0 0 80px rgba(91, 164, 217, 0.12),
113
  inset 0 0 60px rgba(0, 0, 0, 0.5),
114
  0 20px 60px rgba(0, 0, 0, 0.8);
115
  }
116
 
117
+ /* decorative bezel rivets — medicine wheel */
118
+ .crt-container::before,
119
+ .crt-container::after {
120
+ content: "◈";
121
+ position: absolute;
122
+ top: 8px;
123
+ color: var(--asp-sunlight);
124
+ opacity: 0.6;
125
+ font-size: 0.9em;
126
+ }
127
+ .crt-container::before { left: 12px; }
128
+ .crt-container::after { right: 12px; }
129
+
130
  .crt-screen {
131
  width: 100%;
132
  height: 100%;
133
  background: var(--terminal-bg);
134
+ border-radius: 12px;
135
  overflow: hidden;
136
  position: relative;
137
+ border: 2px solid #1B4332;
138
+ box-shadow:
139
+ inset 0 0 80px rgba(27, 73, 50, 0.5),
140
+ inset 0 0 4px rgba(255, 179, 71, 0.2);
141
  }
142
 
143
+ /* Scanlines — birch-bark rings reinterpreted */
144
  .scanlines {
145
  position: absolute;
146
  top: 0; left: 0; right: 0; bottom: 0;
 
148
  0deg,
149
  transparent,
150
  transparent 2px,
151
+ rgba(91, 164, 217, var(--scanline-opacity)) 2px,
152
+ rgba(91, 164, 217, var(--scanline-opacity)) 4px
153
  );
154
  pointer-events: none;
155
  z-index: 10;
156
  }
157
 
158
+ /* Vignette — horizon glow */
159
  .vignette {
160
  position: absolute;
161
  top: 0; left: 0; right: 0; bottom: 0;
162
+ background: radial-gradient(
163
+ ellipse at 50% 30%,
164
+ rgba(242, 169, 59, 0.05) 0%,
165
+ transparent 50%,
166
+ rgba(15, 26, 44, 0.55) 100%
167
+ );
168
  pointer-events: none;
169
  z-index: 10;
170
  }
171
 
172
+ /* CRT reflection/glare — frost on glass */
173
  .crt-reflection {
174
  position: absolute;
175
  top: 5%;
 
178
  height: 30%;
179
  background: linear-gradient(
180
  135deg,
181
+ rgba(190, 233, 232, 0.05) 0%,
182
  transparent 100%
183
  );
184
  pointer-events: none;
 
186
  border-radius: 50%;
187
  }
188
 
189
+ /* === TERMINAL LAYOUT ================================================== */
190
  .terminal {
191
  width: 100%;
192
  height: 100%;
 
195
  padding: 15px 20px;
196
  position: relative;
197
  z-index: 5;
198
+ color: var(--asp-birch);
199
  }
200
 
201
  .terminal-header {
 
203
  justify-content: space-between;
204
  align-items: center;
205
  padding-bottom: 10px;
206
+ border-bottom: 1px solid rgba(91, 164, 217, 0.3);
207
  margin-bottom: 10px;
208
  font-size: 0.75rem;
209
+ color: var(--asp-frost);
210
  text-transform: uppercase;
211
  letter-spacing: 2px;
212
+ font-family: Georgia, serif;
213
  }
214
+ .terminal-header .status {
215
+ color: var(--asp-sunlight);
216
+ text-shadow: 0 0 8px rgba(242, 169, 59, 0.35);
217
+ }
218
+ #health-val { color: var(--asp-sun); font-weight: bold; }
219
 
220
+ /* === TERMINAL OUTPUT ================================================== */
 
 
 
221
  .terminal-body {
222
  flex: 1;
223
  overflow-y: auto;
224
  overflow-x: hidden;
225
  padding-right: 10px;
226
+ font-size: 0.88rem;
227
+ line-height: 1.65;
228
+ text-shadow: 0 0 6px rgba(242, 169, 59, 0.15);
229
  scroll-behavior: smooth;
230
  }
 
231
  .terminal-body::-webkit-scrollbar { width: 6px; }
232
  .terminal-body::-webkit-scrollbar-track { background: transparent; }
233
  .terminal-body::-webkit-scrollbar-thumb {
234
+ background: rgba(91, 164, 217, 0.3);
235
  border-radius: 3px;
236
  }
237
 
 
238
  .line {
239
  display: block;
240
  margin-bottom: 3px;
241
  opacity: 0;
242
  animation: typeIn 0.5s forwards;
243
  }
244
+ .line.success { color: var(--asp-sunlight); }
245
+ .line.error { color: var(--asp-ember); }
246
+ .line.amber { color: var(--asp-sun); }
247
 
248
  .story-text {
249
  display: block;
250
+ margin: 14px 0;
251
+ padding: 12px 16px;
252
+ border-left: 2px solid var(--asp-sun);
253
+ background: rgba(91, 164, 217, 0.06);
254
+ border-radius: 0 4px 4px 0;
255
  white-space: pre-wrap;
256
+ color: var(--asp-birch);
257
  animation: fadeSlideIn 0.6s ease-out;
258
+ box-shadow: inset 0 0 20px rgba(15, 26, 44, 0.3);
259
  }
260
 
261
  .narrator-prefix {
262
+ color: var(--asp-sun);
263
  font-weight: bold;
264
+ text-shadow: 0 0 8px rgba(242, 169, 59, 0.4);
265
  }
266
 
267
  .player-action {
268
  display: block;
269
+ color: var(--asp-frost);
270
  margin: 5px 0;
271
  font-style: italic;
272
+ border-left: 2px dashed rgba(190, 233, 232, 0.4);
273
+ padding-left: 8px;
274
  }
275
 
276
  .game-over-win {
277
+ color: var(--asp-sunlight);
278
+ text-shadow: 0 0 20px rgba(255, 179, 71, 0.6);
279
+ font-size: 1.15rem;
280
  text-align: center;
281
  padding: 20px;
282
  animation: pulse 2s infinite;
283
+ font-family: Georgia, serif;
284
  }
285
 
286
  .game-over-lose {
287
+ color: var(--asp-ember);
288
+ text-shadow: 0 0 20px rgba(231, 111, 81, 0.5);
289
+ font-size: 1.15rem;
290
  text-align: center;
291
  padding: 20px;
292
  animation: pulse 2s infinite;
293
+ font-family: Georgia, serif;
294
  }
295
 
296
+ /* === GENRE SELECTOR =================================================== */
297
  .genre-selector {
298
  display: flex;
299
  gap: 15px;
300
  padding: 15px 0;
301
  justify-content: center;
302
+ flex-wrap: wrap;
303
  }
304
 
305
  .genre-option {
306
  padding: 12px 25px;
307
+ border: 1px solid rgba(91, 164, 217, 0.4);
308
  border-radius: 4px;
309
  cursor: pointer;
310
  transition: all 0.2s;
311
  text-transform: uppercase;
312
+ letter-spacing: 1.5px;
313
  font-size: 0.8rem;
314
+ color: var(--asp-frost);
315
+ background: rgba(15, 26, 44, 0.4);
316
  }
317
 
318
  .genre-option:hover {
319
+ background: linear-gradient(95deg, rgba(242, 169, 59, 0.2) 0%, rgba(91, 164, 217, 0.2) 100%);
320
+ color: var(--asp-sunlight);
321
+ border-color: var(--asp-sun);
322
+ text-shadow: 0 0 12px rgba(242, 169, 59, 0.6);
323
+ box-shadow: 0 0 18px rgba(242, 169, 59, 0.3);
324
+ transform: translateY(-1px);
325
  }
326
 
327
+ .genre-option .icon { margin-right: 8px; font-size: 1.1em; color: var(--asp-sun); }
328
 
329
+ /* === CHOICE BUTTONS =================================================== */
330
  .choices-container {
331
  display: flex;
332
  flex-direction: column;
 
337
  .choice-btn {
338
  display: block;
339
  padding: 10px 15px;
340
+ border: 1px solid rgba(91, 164, 217, 0.4);
341
  border-radius: 3px;
342
  background: transparent;
343
+ color: var(--asp-frost);
344
  font-family: 'MonoFallback', monospace;
345
+ font-size: 0.82rem;
346
  cursor: pointer;
347
  text-align: left;
348
  transition: all 0.15s;
349
+ text-shadow: 0 0 3px rgba(91, 164, 217, 0.25);
350
  }
351
 
352
  .choice-btn:hover {
353
+ background: rgba(91, 164, 217, 0.1);
354
+ border-color: var(--asp-sun);
355
+ color: var(--asp-sunlight);
356
  padding-left: 25px;
357
+ box-shadow: 0 0 12px rgba(242, 169, 59, 0.2);
358
  }
359
 
360
  .choice-btn::before {
361
+ content: '☼ ';
362
+ color: var(--asp-sun);
363
+ margin-right: 4px;
364
  }
365
 
366
+ /* === INPUT LINE ======================================================= */
367
  .input-line {
368
  display: flex;
369
  align-items: center;
370
  padding: 10px 0 5px;
371
+ border-top: 1px solid rgba(91, 164, 217, 0.3);
372
  margin-top: 5px;
373
  }
374
 
375
  .prompt-char {
376
+ color: var(--asp-sun);
377
  margin-right: 8px;
378
  font-weight: bold;
379
+ text-shadow: 0 0 8px rgba(242, 169, 59, 0.5);
380
  }
381
 
382
  #cmd-input {
383
  flex: 1;
384
  background: transparent;
385
  border: none;
386
+ color: var(--asp-birch);
387
  font-family: 'MonoFallback', monospace;
388
+ font-size: 0.88rem;
389
  outline: none;
390
  caret-color: transparent;
391
  }
392
 
393
  .cursor {
394
+ color: var(--asp-sun);
395
+ text-shadow: 0 0 6px rgba(242, 169, 59, 0.6);
396
  animation: blink 0.8s step-end infinite;
397
  }
398
 
399
+ /* === TERMINAL FOOTER ================================================== */
400
  .terminal-footer {
401
  display: flex;
402
  justify-content: space-between;
403
  padding-top: 8px;
404
+ border-top: 1px solid rgba(91, 164, 217, 0.2);
405
  margin-top: 8px;
406
  font-size: 0.65rem;
407
+ color: var(--asp-stone);
408
+ letter-spacing: 1.5px;
409
  }
410
 
411
+ #model-status { color: var(--asp-moss); }
412
 
413
+ /* === HEALTH BAR ====================================================== */
414
  .health-bar-visual {
415
  width: 100%;
416
  height: 4px;
417
+ background: rgba(15, 26, 44, 0.6);
418
  border-radius: 2px;
419
  margin-top: 5px;
420
  overflow: hidden;
421
+ border: 1px solid rgba(91, 164, 217, 0.3);
422
  }
423
 
424
  .health-bar-fill {
425
  height: 100%;
426
+ background: linear-gradient(90deg, var(--asp-sun) 0%, var(--asp-sunlight) 100%);
427
  transition: width 0.5s ease, background-color 0.5s;
428
  border-radius: 2px;
429
+ box-shadow: 0 0 8px rgba(242, 169, 59, 0.5);
430
  }
431
 
432
+ .health-bar-fill.low { background: linear-gradient(90deg, var(--asp-ember) 0%, var(--asp-terra) 100%); }
433
+ .health-bar-fill.mid { background: linear-gradient(90deg, var(--asp-sun) 0%, var(--asp-amber, #FFB347) 100%); }
434
 
435
+ /* === NEW GAME BUTTON ================================================= */
436
  .new-game-btn {
437
  display: inline-block;
438
+ padding: 10px 22px;
439
+ border: 1px solid rgba(91, 164, 217, 0.4);
440
  border-radius: 3px;
441
  background: transparent;
442
+ color: var(--asp-frost);
443
  font-family: 'MonoFallback', monospace;
444
+ font-size: 0.78rem;
445
  cursor: pointer;
446
  text-transform: uppercase;
447
+ letter-spacing: 1.5px;
448
  margin-top: 10px;
449
  transition: all 0.2s;
450
  }
451
 
452
  .new-game-btn:hover {
453
+ background: linear-gradient(95deg, rgba(242, 169, 59, 0.2) 0%, rgba(91, 164, 217, 0.2) 100%);
454
+ color: var(--asp-sunlight);
455
+ border-color: var(--asp-sun);
456
+ box-shadow: 0 0 16px rgba(242, 169, 59, 0.35);
457
  }
458
 
459
+ /* === ANIMATIONS ====================================================== */
460
  @keyframes typeIn {
461
  from { opacity: 0; transform: translateY(5px); }
462
  to { opacity: 1; transform: translateY(0); }
463
  }
 
464
  @keyframes fadeSlideIn {
465
  from { opacity: 0; transform: translateX(-10px); }
466
  to { opacity: 1; transform: translateX(0); }
467
  }
 
468
  @keyframes blink {
469
  50% { opacity: 0; }
470
  }
 
471
  @keyframes pulse {
472
  0%, 100% { opacity: 1; }
473
+ 50% { opacity: 0.65; }
474
  }
475
 
476
+ /* CRT power-on (sun rising) */
477
  .crt-screen {
478
+ animation: sunRise 0.7s ease-out;
479
  }
480
+ @keyframes sunRise {
481
+ 0% { opacity: 0; transform: scaleY(0.01); box-shadow: inset 0 0 0 rgba(242, 169, 59, 0); }
482
+ 40% { opacity: 1; transform: scaleY(0.01); }
483
+ 60% { transform: scaleY(1.05); }
484
+ 80% { transform: scaleY(0.98); }
485
+ 100% { transform: scaleY(1); box-shadow: inset 0 0 80px rgba(27, 73, 50, 0.5); }
 
486
  }
487
 
488
+ /* === MOBILE ========================================================== */
489
  @media (max-width: 600px) {
490
  .crt-container {
491
  width: 95vw;
492
+ height: 78vh;
493
  padding: 12px;
494
+ border-radius: 14px;
495
  }
496
  .genre-selector { flex-direction: column; gap: 8px; }
497
  .genre-option { text-align: center; }
498
+ .terminal-body { font-size: 0.78rem; }
499
+ .asp-banner { font-size: 0.85em; }
500
  }
shared/anishinaabe_solarpunk.py ADDED
@@ -0,0 +1,157 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """
2
+ ᐴ ANISHINAABE-SOLARPUNK DESIGN TOKENS ᔔ
3
+ ═════════════════════════════════════════════════════════════════════════════════
4
+ Shared aesthetic module for the build-small-hackathon monorepo.
5
+
6
+ Combines:
7
+ - Anishinaabe cultural elements (Canadian Aboriginal Syllabics, medicine wheel
8
+ motifs, natural color references from Anishinaabe Aki / land)
9
+ - Solarpunk visual language (warm sun tones, biophilic greens, sky blues,
10
+ hope, low-tech, regenerative)
11
+
12
+ Each project imports PALETTE / SYMBOLS / HEADER / FOOTER to render a consistent
13
+ aesthetic across TinyBard, FocusFriend, and CritterCalm.
14
+ """
15
+
16
+ # ── CANADIAN ABORIGINAL SYLLABICS ──────────────────────────────────────────────
17
+ PUU = "\u1438" # ᐸ CANADIAN SYLLABICS PUU (left frame)
18
+ SHOO = "\u1514" # ᔔ CANADIAN SYLLABICS SHOO (right frame)
19
+ BII = "\u142A" # ᐪ CANADIAN SYLLABICS BII
20
+ MII = "\u14A1" # ᑡ CANADIAN SYLLABICS MII (sometimes used in greetings)
21
+ WA = "\u1418" # ᐘ CANADIAN SYLLABICS WA
22
+ GO = "\u1472" # ᑲ CANADIAN SYLLABICS KA
23
+ AN = "\u14B0" # ᒐ CANADIAN SYLLABICS AN (short)
24
+ KITA = "\u13E3" # Ꮳ CANADIAN SYLLABICS C — used in "Anishinaabe"
25
+
26
+ # ── SOLARPUNK / NATURE MOTIFS ──────────────────────────────────────────────────
27
+ SUN_RAY = "\u263C" # ☼ WHITE SUN WITH RAYS
28
+ SUN_BLACK = "\u2600" # ☀ BLACK SUN WITH RAYS
29
+ LEAF = "\u2618" # ☘ SHAMROCK (biophilic stand-in)
30
+ FLOWER = "\u2740" # ❀ WHITE FLORETTE
31
+ MEDICINE_WHEEL = "\u2697" # ⚗ alembic; rotated medicine wheel feel
32
+ ARROW_UP = "\u21B3" # ↳ arrow (solarpunk hope = rising)
33
+ CIRCUIT = "\u25C8" # ◈ WHITE DIAMOND CONTAINING BLACK SMALL DIAMOND
34
+ DIAMOND = "\u25C6" # ◆ BLACK DIAMOND
35
+ DIAMOND_O = "\u25C7" # ◇ WHITE DIAMOND
36
+
37
+ # ── COLOR PALETTE ──────────────────────────────────────────────────────────────
38
+ PALETTE = {
39
+ # Sky and water
40
+ "sky": "#5BA4D9", # light Anishinaabe sky (morning)
41
+ "water": "#1B4965", # deep lake water (Gichigami)
42
+ "ice": "#BEE9E8", # spring thaw
43
+ "frost": "#CAF0F8", # winter light
44
+ # Sun
45
+ "sun": "#F2A93B", # rising sun amber
46
+ "sunlight": "#FFB347", # warm ray
47
+ "ember": "#E76F51", # dusk ember
48
+ # Earth
49
+ "birch": "#F5F1E8", # birchbark white
50
+ "terracotta":"#C8553D", # clay / medicine wheel red
51
+ "earth": "#8B3A1F", # deep earth / copper
52
+ "moss": "#588157", # forest moss
53
+ "forest": "#3D6A4A", # cedar forest
54
+ "spruce": "#1B4332", # deep spruce (night)
55
+ # Contrast
56
+ "night": "#0F1A2C", # deep night sky
57
+ "ash": "#3A2E2A", # woodsmoke
58
+ "stone": "#A89F91", # river stone
59
+ "ink": "#1A1F2E", # deep ink
60
+ }
61
+
62
+ # ── PROJECT FRAMING ───────────────────────────────────────────────────────────
63
+ def header(title: str, en: str) -> str:
64
+ """Solarpunk + Anishinaabe banner header for a project.
65
+
66
+ Usage:
67
+ header("TinyBard", "MICRO TEXT ADVENTURE")
68
+ """
69
+ line = f"{DIAMOND}{CIRCUIT}{DIAMOND_O}"
70
+ return (
71
+ f"\n{line}{CIRCUIT}{PUU} {title} {SHOO} [{en.upper()}] "
72
+ f"{CIRCUIT}{line}\n"
73
+ )
74
+
75
+
76
+ def footer() -> str:
77
+ """Closing banner."""
78
+ return f"\n{DIAMOND_O}{CIRCUIT}{DIAMOND} {SUN_RAY} \u00b7 {LEAF} \u00b7 {WATER_ICON()} \u00b7 {SUN_BLACK} {CIRCUIT}{DIAMOND}{DIAMOND_O}\n"
79
+
80
+
81
+ def WATER_ICON() -> str:
82
+ # wave-like water (using box-drawing)
83
+ return "\u2248" # ≈ (approx, like a wave)
84
+
85
+
86
+ # ── THEME CONSTANTS (CSS variables) ──────────────────────────────────────────
87
+ CSS_VARS = f"""
88
+ :root {{
89
+ --asp-sky: {PALETTE['sky']};
90
+ --asp-water: {PALETTE['water']};
91
+ --asp-ice: {PALETTE['ice']};
92
+ --asp-sun: {PALETTE['sun']};
93
+ --asp-sunlight: {PALETTE['sunlight']};
94
+ --asp-ember: {PALETTE['ember']};
95
+ --asp-birch: {PALETTE['birch']};
96
+ --asp-terra: {PALETTE['terracotta']};
97
+ --asp-earth: {PALETTE['earth']};
98
+ --asp-moss: {PALETTE['moss']};
99
+ --asp-forest: {PALETTE['forest']};
100
+ --asp-spruce: {PALETTE['spruce']};
101
+ --asp-night: {PALETTE['night']};
102
+ --asp-ash: {PALETTE['ash']};
103
+ --asp-stone: {PALETTE['stone']};
104
+ --asp-ink: {PALETTE['ink']};
105
+ }}
106
+ """
107
+
108
+
109
+ # ── SHARED CSS SNIPPETS ────────────────────────────────────────────────────���──
110
+ def style_banner() -> str:
111
+ """A standard top-of-app banner with Anishinaabe + Solarpunk styling."""
112
+ return """
113
+ /* === ANISHINAABE-SOLARPUNK BANNER =================================== */
114
+ .asp-banner {
115
+ display: flex;
116
+ align-items: center;
117
+ justify-content: center;
118
+ gap: 0.6em;
119
+ padding: 14px 18px;
120
+ background: linear-gradient(95deg, var(--asp-sky) 0%, var(--asp-water) 100%);
121
+ color: var(--asp-birch);
122
+ border-bottom: 1px solid rgba(255, 179, 71, 0.35);
123
+ font-family: Georgia, 'Iowan Old Style', serif;
124
+ letter-spacing: 0.5px;
125
+ text-shadow: 0 1px 2px rgba(15, 26, 44, 0.35);
126
+ }
127
+ .asp-banner .syll { font-size: 1.4em; opacity: 0.85; }
128
+ .asp-banner .title { font-size: 1.05em; font-weight: 600; }
129
+ .asp-banner .glyph {
130
+ display: inline-block;
131
+ transform: translateY(-1px);
132
+ font-size: 1.1em;
133
+ color: var(--asp-sunlight);
134
+ }
135
+ /* ===================================================================== */
136
+ """
137
+
138
+
139
+ # ── WELCOME TEXT ──────────────────────────────────────────────────────────────
140
+ WELCOME = (
141
+ f"{PUU} Aaniin {SHOO} \u2014 Welcome. The land remembers you. "
142
+ f"{SUN_RAY} {LEAF} {WATER_ICON()}"
143
+ )
144
+
145
+
146
+ # ── CHARACTER (TinyBard, FocusFriend) ────────────────────────────────────────
147
+ PIP_GREETING_SOLARPUNK = (
148
+ f"{PUU} Aaniin, amiikwens {SHOO} \u2014 I am Pip, the friend of the moss "
149
+ f"and the small winds. Sit. Breathe. The sun is in no hurry. {SUN_BLACK}"
150
+ )
151
+
152
+
153
+ if __name__ == "__main__":
154
+ print(header("Build Small Hackathon", "AINISH CODER SANCTUARY"))
155
+ print(WELCOME)
156
+ print(PIP_GREETING_SOLARPUNK)
157
+ print(footer())