Architecture Blueprint v1.0

Portable AI
for the Classroom

A quiet knowledge infrastructure for underserved Filipino learners β€” offline-first, dignity-first, sovereignty-first.

"You are not building AI tools. You are building scientific dignity."

🌌 Philosophical Foundation

Understanding what this project truly is before writing a single line of code or buying a single component.

"Science should widen humility, not inflate competition."
β€” The core principle from which everything else flows

πŸ”‹ A Voltage Regulator for Perspective

Just as a UPS stabilizes power through brownouts, this system stabilizes cognitive access through infrastructure gaps. Survival stress compresses perspective. Science expands it β€” placing hardship inside cosmic scale without diminishing dignity.

🌱 A Quiet Knowledge Root System

Not a search engine. Not a chatbot. A steady, patient presence β€” like a lighthouse that doesn't chase ships, but makes wisdom quietly available to those who seek it. The website, the kit, and the content all serve one function: being findable when needed.

πŸ›‘ Structural Sovereignty

Internet = enhancement, never dependency. This system operates in areas where Manila infrastructure does not reach. It is designed around this reality β€” not as a limitation, but as a core feature. Offline-first is not a compromise. It is the product.

πŸ‡΅πŸ‡­ Scientific Dignity

Filipino learners in provinces should not feel that knowledge is a foreign luxury. This kit contextualizes science inside Filipino culture β€” humility + scale awareness = grounded strength. Not chasing dominance. Building belonging.

Three Deliverables From One Vision
🌐
Phase 1 β€” Website Root
aiawarenessinspired.cloud acts as the cultural indexing layer. Calm tone, deep articles, SEO-searchable for Filipino questions about universe, science, AI.
πŸ“¦
Phase 2 β€” Portable AI Kit
The physical edge node. Mini PC + local LLM + offline curriculum. Deployable in barangay classrooms, far from fiber internet.
πŸ“š
Phase 3 β€” Content Layer
Preloaded Philippine science curriculum, AI literacy modules, bias awareness, and physics fundamentals β€” all in Filipino and English.

πŸ— System Architecture Overview

A layered, resilient architecture built on the principle: local-first, cloud-never-required.

PHYSICAL SYSTEM AI LAYER USER ⚑ UPS 650VA / 360W Brownout Guard β˜€οΈ Solar Input Optional 50–100W Panel + Controller πŸ–₯ Mini PC (Core) 16–32GB RAM Β· 1TB SSD Intel N100 / AMD Ryzen Β· <60W Fanless or silent build recommended πŸ“Ά WiFi Hotspot Local AP Β· No internet Students connect here πŸ–₯ Display Optional Monitor For teacher dashboard 🐧 OS Layer Ubuntu 22.04 LTS Journaling FS (ext4) Auto-recovery βš™οΈ Sync Daemon Background process Internet detect + OTA Runs at 3AM daily πŸ”Œ Local API Server FastAPI / llama.cpp Serves student requests Port 8080 / LAN only πŸ“‹ Session Mgr User sessions Local logs (encrypted) Auto-purge 30 days πŸ”Œ USB Update Manual OTA mode Zero internet areas Admin-managed 🧠 Core LLM 7B–8B Quantized GGUF Llama 3 / Mistral v0.3 Filipino + English tuned πŸ“š RAG Engine FAISS Local Vector DB PH Curriculum embedded Rebuild in <2 min πŸ›‘ Safety Layer Age-appropriate filter Prompt guardrails Bias awareness module πŸ”„ Delta Patcher Upgrade patches only No full redownload Offline-safe rollback πŸ‘©β€πŸŽ“ Student UI Web browser (LAN) Ask questions Β· Explore πŸ‘©β€πŸ« Teacher UI Dashboard Β· Analytics Topic management πŸ‘¨β€πŸ’Ό Admin UI System health Β· Updates USB management ☁️ Cloud (Optional) Analytics Β· Federated updates NEVER required for operation
● Required Core system components
● Optional Enhanced feature components
● Guard Safety & security components
Dashed = optional/enhancement layer

πŸ”§ Hardware Assembly

Everything fits in a small carry case. A teacher can set it up in under 5 minutes. A UPS in the classroom for knowledge.

πŸ–₯

Mini PC

Silent form-factor. Fits in a backpack. Powers the entire AI system.

16–32GB DDR5
1TB NVMe SSD
<60W TDP
⚑

UPS Unit

Sustains at least 20 min runtime on outage. Same thinking as data center β€” stability is dignity.

650–1200VA
Auto-shutdown
APC / Eaton
πŸ“Ά

WiFi Access Point

Creates a local hotspot. Students connect via browser. No internet required β€” just LAN.

802.11ac/ax
20–30 devices
TP-Link / Ruijie
β˜€οΈ

Solar Input

Optional for off-grid barangays. Paired with a battery controller for stable DC input.

50–100W panel
PWM controller
Optional only
πŸ–₯

Display

Optional classroom monitor for teacher dashboard and group Q&A mode.

21"–27" FHD
HDMI input
Optional
πŸ’Ύ

USB Drives (2x)

One for USB OTA updates, one for backup. Essential for zero-internet areas.

32–64GB USB 3.0
Update + Backup
Always included
PORTABLE CARRY CASE β€” EVERYTHING FITS INSIDE ⚑ UPS 650VA DC Power πŸ–₯ Mini PC 16–32GB Β· 1TB Β· <60W Intel N100 or Ryzen 5 LAN/USB πŸ“Ά WiFi AP LAN Hotspot πŸ“± Students πŸ’Ύ USB Update πŸ’Ύ USB Backup β˜€οΈ Solar (Optional) 50–100W panel 🌐 Internet (Optional Enhancement) Update syncs Β· Never required for operation
Bill of Materials β€” Estimated Philippine Pricing
Component Spec Est. Cost (PHP) Priority
Mini PC Intel N100, 16GB RAM, 512GB SSD β‚±8,000 – 14,000 REQUIRED
RAM Upgrade To 32GB DDR5 (for larger models) β‚±3,000 – 5,000 UPGRADE
NVMe SSD 1TB For full model + curriculum storage β‚±2,500 – 4,000 REQUIRED
UPS 650VA APC BX650 or equivalent β‚±3,500 – 5,000 REQUIRED
WiFi AP TP-Link EAP or Ruijie RG-AP β‚±2,000 – 4,500 REQUIRED
USB Drives (2x) 64GB USB 3.0 β€” update + backup β‚±600 – 1,000 REQUIRED
Carry Case Foam-padded, lockable β‚±1,500 – 3,000 REQUIRED
Solar Panel Kit 50W panel + PWM controller β‚±4,000 – 7,000 OPTIONAL
TOTAL (Core) Without solar, without monitor β‚±21,100 – 36,500 FEASIBLE

* Prices based on Lazada/Shopee PH and local IT suppliers as of early 2025. Kit can be assembled at β‚±25,000 target.

πŸ“‘ Operating Modes

Three clearly defined operating states. The experience is identical for students in all three β€” the system handles the rest silently.

🟒 MODE 1

Full Offline β€” Total Outage
  • All AI inference runs locally
  • Local RAG knowledge base active
  • Local user logs stored encrypted
  • No warning shown to users
  • No degradation in experience
  • It just works. Silently.
Student Experience: Identical

🟑 MODE 2

Intermittent Internet
  • Internet detected automatically
  • Background daemon pings update server
  • Device authenticates via API key
  • Downloads: model patches, curriculum updates, language packs, security patches
  • Updates run at 3AM β€” no interruption
  • Returns to offline mode after sync
Student Experience: Unchanged

πŸ”΅ MODE 3

Stable Internet
  • All Mode 2 features active
  • Cloud backup sync available
  • Anonymized analytics sync
  • Federated knowledge update
  • Teacher dashboard: cloud view
  • NEVER a dependency β€” enhancement only
Student Experience: Same + richer content
System Start Internet? detect ping NO 🟒 MODE 1 Full offline β€” continue normally YES Stable? bw threshold LOW BW 🟑 MODE 2 Background sync Β· Skip if too slow STABLE πŸ”΅ MODE 3 Full sync + cloud enhancements Analytics Β· Federated updates 🧠 Local AI Inference Always running β€” never interrupted

πŸ”„ Intelligent Sync Logic Flow

The operational heartbeat of the system. Silent, patient, and fail-safe. A process that never interrupts learning.

πŸ” Student Request Flow
1

Student Sends Query

Via browser on phone/laptop connected to local WiFi. Asks in Filipino or English. No login required.

0ms network latency β€” all local
2

Safety Layer Check

Input passes through age-appropriate filter and guardrails. Bias-awareness module flags sensitive framing. Calm, non-threatening response mode enforced.

Child-safe by design
3

RAG Retrieval

Query is embedded and matched against local FAISS vector database containing Philippine curriculum, science modules, and AI literacy content.

Context-grounded answers
4

LLM Generation

7B quantized model generates response using retrieved context. Temperature tuned low for educational accuracy. Max 400 tokens for clarity.

Fully local Β· No cloud call
5

Response Delivered

Student sees answer in browser. Calm, plain language. No flashy animation. Response logged locally, encrypted. Purged after 30 days.

Simple Β· Clear Β· Dignified
πŸŒ™ Background Sync Flow (Nightly)
A

3 AM β€” Daemon Wakes

Background process activates. Does not wake users. Does not interrupt any active session. Completely transparent to the classroom.

No UI notification ever
B

Internet Detection

Pings lightweight health-check endpoint. If no response in 3 seconds β€” skip entirely. Resume offline mode with zero change.

Fail-silent Β· No alarm
C

Bandwidth Check

If internet found, checks available bandwidth. Below threshold (e.g. 512kbps)? Skip this cycle. Reschedule to next 6-hour window.

Smart scheduling
D

Authenticated Sync

Device authenticates with API key. Downloads delta patch package (not full redownload). Verifies SHA-256 checksum before applying. Rolls back if verification fails.

Verified Β· Tamper-proof
E

Patch Applied, RAG Rebuilt

Model delta applied. FAISS vector index rebuilt from new curriculum packs. Total downtime: under 2 minutes. System restores automatically. Logs sync result locally.

Seamless update Β· Auto-restore
Power Recovery Logic

After every brownout or power failure β€” the system must restore itself without teacher intervention.

⚑ Power Lost
UPS takes over
β†’
πŸ’Ύ Journaling FS
No data corruption
β†’
πŸ”„ Auto-boot
systemd services
β†’
πŸ“Ά WiFi Restores
AP reboots
β†’
βœ… Ready in <2 min
Teacher plugs in β†’ done

πŸ“± Application Interface Layout

Three role-based views: Student, Teacher, and Admin. Accessible via any browser on the local WiFi network.

System Healthy Β· 14 Students Connected Β· RAM: 62%
Thu 8:42 AM Β· Grade 7 Science
LIWANAG AI
Magandang umaga! I'm here to help you explore science. What are you curious about today? You can ask me anything β€” in Filipino or English.
Gaano kakalayo ang mga bituin? Parang ang liit liit ko.
LIWANAG AI
That feeling you have β€” that sense of smallness β€” is actually one of the most profound things a human can experience. Scientists call it the "overview effect."

The nearest star to our Sun, Proxima Centauri, is about 4.24 light-years away. That means even if we traveled at the speed of light β€” 300,000 km per second β€” it would take over 4 years just to arrive there.

But here's what's beautiful: you are made of atoms forged inside stars billions of years ago. You are not small. You are made of the very thing you are marveling at. 🌟
Suggested Topics
How big is the universe? Paano nabuo ang mundo? What is DNA? Why is the sky blue? Ano ang AI?
System Status
Mode ● OFFLINE
Model Llama-3 8B Q4
RAG Index ● Active
Last Updated Jan 14, 2025
Uptime 6h 42m
Today's Class
Grade 7 Earth Science
Chapter 4: The Solar System and Beyond
14 students active Β· 47 questions asked today
Three User Roles β€” Same System, Different Views
πŸ‘©β€πŸŽ“
Student View
Simple chat interface. Topic sidebar. Language toggle. Saved answers. No account needed β€” just connect to WiFi and ask.
πŸ‘©β€πŸ«
Teacher View
Class dashboard. See what students are asking. Assign topics. View session analytics. Flag interesting questions for group discussion.
πŸ‘¨β€πŸ’Ό
Admin View
System health. USB update manager. Sync status. Storage monitoring. User log purge controls. Deployment kit management.

πŸ’‘ Design Improvements & Insights

Additions and refinements to strengthen the original framework β€” preserving its soul while sharpening its structure.

What the Original Document Does Exceptionally Well

The philosophical grounding is rare and powerful. Most ed-tech projects lead with hardware specs. This one leads with dignity. The UPS analogy is perfect β€” it teaches the product's purpose in one sentence. The three-mode network design is technically sound and production-grade. The fail-silent principle is correct and caring. The data sovereignty approach (no personal data, auto-purge) will be essential for DepEd and NGO trust. The USB manual update path is an often-missed but critical inclusion for zero-connectivity areas.

🌐

Add: Cebuano / Hiligaynon Language Support

Filipino and English are assumed, but the Philippines has 8 major regional languages. Visayas and Mindanao classrooms speak Cebuano and Hiligaynon. Adding even basic language detection and response in these languages would dramatically expand reach and emotional belonging. The model can be prompted to respond in dialect when detected.

PRIORITY: HIGH
πŸ§‘β€πŸ«

Add: Teacher "Lesson Mode" β€” Guided Prompting

Teachers should be able to set a "lesson context" for the day (e.g., "Chapter 4: Solar System") so that student questions are automatically scoped and contextualized. This prevents off-topic rabbit holes and ties AI answers back to curriculum. The LLM receives the lesson context as a system prompt for that session window.

PRIORITY: HIGH
πŸ“Š

Add: Curiosity Heatmap (Anonymous)

Track which topics students ask about most frequently β€” in aggregate, never individually. This data helps curriculum designers understand what Filipino students are actually curious about vs. what is taught. The heatmap should be visible to teachers and, when connected, to a central research dashboard. This is scientifically valuable data, not surveillance.

PRIORITY: MEDIUM
⚑

Improve: Power Budget Precision

The "<60W continuous" target is good but needs to account for peak loads. An Intel N100 Mini PC at full LLM inference load can hit 30–40W. Add WiFi AP at 8–12W, UPS overhead, and display if present β€” total can reach 70–80W peak. Recommend specifying a 1200VA UPS (not 650VA) if solar input is not available, and defining a thermal throttle policy for sustained inference sessions in warm classroom environments (common in Philippine provinces without aircon).

PRIORITY: HIGH β€” Infrastructure Risk
πŸ›‘

Improve: Security Model for Device Registration

The API key / token authentication described in Mode 2 is correct but needs expansion. Recommend: (1) Device fingerprint at provisioning time, (2) Rotating token system (30-day expiry), (3) Update package encryption with device-specific public key. This ensures that even if a USB update drive is stolen, the package cannot be replayed on an unauthorized device. Critical for DepEd trust.

PRIORITY: HIGH β€” Trust Requirement
πŸ“¦

Add: "Kit-in-a-Box" Deployment Standard

Define a reproducible deployment standard: a single USB stick that bootstraps the entire system from a bare Mini PC in under 20 minutes. Include a setup checklist printed inside the carry case lid. This enables NGOs, LGUs, and barangay volunteers to deploy kits without technical expertise. The democratization of the deployment, not just the AI, is what creates scale.

PRIORITY: HIGH β€” Scalability
🎭

Add: AI Persona β€” "Liwanag"

The system needs a name and a character β€” not a corporate AI, but a humble Filipino guide. "Liwanag" (light/clarity in Filipino) fits perfectly with the lighthouse philosophy. Give it a consistent voice: patient, curious, never condescending. "Liwanag" references Philippine heroes, local geography, and cultural examples in its answers. This transforms a tool into a companion β€” and companions get used.

PRIORITY: MEDIUM β€” Adoption Driver
πŸ“‘

Add: Phase 3 β€” Federated Learning Network

Long-term vision: when multiple Liwanag kits are deployed across provinces, enable a privacy-preserving federated learning update. Each kit contributes anonymized interaction patterns to improve the shared model β€” without any personal data leaving the device. This creates a model that becomes more Filipino over time, trained by Filipino students, for Filipino students. This is the true network effect of dignity at scale.

PRIORITY: LONG-TERM VISION
"Growth is not found in the noise of the Awakening,
but in the steady, patient rhythm of Awareness-Inspired utility."
β€” AI Awareness Inspired Β· The heart of everything this system does