Yachay Wasi: Community Information Protocol — Core Components
A community-owned SMS service for health, fair prices, and local coordination.
Status and scope
- Purpose: This white paper defines the core components of Yachay Wasi, a practical, steward-led SMS service that delivers topic-based alerts—SALUD (health), PRECIO (fair prices), and COMUNIDAD (coordination)—without internet.
- Origin: Yachay Wasi is the refined outcome of an exploratory research phase that tested multiple message transports and consent approaches. All non-SMS components are archived. The focus is immediate utility, FPIC compliance, and community stewardship.
- Technical status: Fully coded and validated technically via unit tests, integration tests, and SMS simulation in a controlled lab environment. There has been no deployment in any community and no live GSM testing. Any field validation will occur only after relevant ethics approvals, collective consent (FPIC), and required permits.
Executive summary
In many rural Andean communities, residents commonly report challenges such as traveling long distances to health posts that are closed, receiving below-market prices for agricultural products due to information asymmetry, and difficulty participating in community decisions due to caregiving responsibilities or distance. Yachay Wasi addresses these issues with simple, free-to-receive SMS alerts.
It’s not about AI—it’s about who controls information. Yachay Wasi places that control in community hands.
The real gap: reliable information, not sophistication. Urban centers often receive real-time updates through digital channels; rural communities frequently rely on informal networks. The exclusion many communities experience is not primarily from advanced technologies—it’s from basic, timely information. Yachay Wasi bridges this gap with zero-cost, offline-first alerts using the phones people already have.
Core components: Yachay Wasi’s Community Information Protocol
FPIC-first (collective consent before operation)
- Community assembly grants or revokes consent; status is recorded locally (community_consent = granted|revoked).
- Without “granted,” the system blocks new subscriptions. This aligns operation with free, prior, and informed consent (FPIC).
Steward-led operation (local ownership)
- Authorized stewards (e.g., teachers, health promoters, youth) manage broadcasts by topic via a simple command-line interface: yachay-wasi broadcast --topic salud|precio|comunidad --text "…".
- After setup, no developer is required for routine use. Day-to-day control rests with the community.
Privacy by design (no phone numbers in the database)
- The database stores only salted hashes of phone numbers; it never stores raw MSISDNs.
- Real numbers reside in a steward-managed, offline CSV (phonebook.csv), ideally on encrypted removable media. Numbers are resolved at send-time only.
- Data minimization: short retention windows (TTL) for message logs; no analytics or cloud services.
Simple subscriptions and revocation (human-centered)
- Subscriptions by SMS keywords: SALUD, PRECIO, COMUNIDAD.
- On subscription, the system issues a unique 4-digit user code; communities may print small cards to support local audit and assisted revocation.
- STOP unsubscribes from all topics instantly, with a confirmation listing removed topics. An individual revocation event is recorded for audit.
SMS-first, offline operation (robust and replicable)
- Runs on a low-power Linux device (e.g., Raspberry Pi) with a GSM modem; can be solar-powered.
- Gammu SMSD handles inbound/outbound SMS via file-based spool; a Python bridge applies rules (FPIC gate, subscription, revocation).
- SQLite stores minimal state (community_consent, subscriptions, consent_events, messages, processing_log). A systemd unit keeps the bridge running locally.
Measurable, human impact (not technical breadth)
- The purpose is to reduce wasted trips, improve price awareness, and enable informed participation.
- Impact is measured in time saved, fairness improved, and participation enabled—after ethics approval and FPIC.
Technical snapshot (reference)
- Transport: Gammu SMSD (no internet required).
-
Core tables:
- community_consent: granted/revoked + reason.
- participants: msisdn_hash (salted SHA-256).
- subscriptions: participant_id, topic ∈ {salud, precio, comunidad}, user_code (4 digits).
- consent_events: individual revocations.
- messages, processing_log: basic traceability with TTL.
-
Steward CLI:
yachay-wasi init-dbyachay-wasi community-consent --status granted|revoked --reason "Assembly YYYY-MM-DD"yachay-wasi broadcast --topic salud|precio|comunidad --text "..."
-
Phonebook workflow:
- phonebook.csv (hash → number) kept offline under steward custody; never imported into the database.
- Numbers are resolved locally at send-time only, ideally on encrypted removable media.
Implementation pathway (pilot)
- Phase 1: Community assembly → record FPIC (granted) → train stewards (CLI use, phonebook security, privacy basics).
- Phase 2: Share subscription instructions (posters, assemblies, radio): SALUD, PRECIO, COMUNIDAD.
- Phase 3: First alerts and learning cycle → gather voluntary, ethics-approved feedback on outcomes (e.g., reduction in unnecessary travel, improved price awareness, timely meeting reminders).
Measurement and evaluation (after approvals)
- Time saved: self-reported reductions in unnecessary trips related to health or administration.
- Price awareness: self-reported knowledge of current fair prices before market day.
- Participation: self-reported ability to track/attend assemblies following reminders.
- Stewardship: ability to operate the system locally without external technical support after handover.
Operational risks and mitigations
- SIM theft or misuse → SIM PIN; physical custody; simple inventory logs.
- Device seizure → full-disk encryption; minimal retention; local, encrypted backups under community control.
- Phonebook exposure (PII) → encrypted USB; never email; quarterly rotation; clear custodian and access rules.
- Invalid numbers or failed sends → local logging; CLI shows aggregate outcomes to avoid overwhelming stewards.
- Over-broadcasting/misinformation → simple local verification norms (e.g., two-person rule for sensitive alerts).
Policy recommendations
For Peru
- Fund community information stewards (not AI labs): small grants for hardware kits (low-power device + GSM modem + solar), training, and maintenance.
- Operationalize Law 29735 in basic services: support Quechua SMS keywords for subscription and revocation alongside Spanish, with guidance for public entities and carriers.
- Guarantee zero-cost reception for public-interest SMS and clarify this in regulatory practice.
- Require FPIC and data minimization for any publicly supported alert systems in rural contexts.
For researchers and implementers
- Build tools that solve today’s problems: measure impact in human terms—wasted trips avoided, fair prices secured, participation enabled.
- Publish only with consent; keep code open (MIT) and keep PII out of databases; steward-managed identifiers offline.
- Produce bilingual (ES/QU) materials where feasible and co-develop training with local educators.
Qori Labs’ role and licensing
Qori Labs built the Yachay Wasi codebase as a public good under the MIT License.
We provide initial hardware and training where funded. Long-term operation, consent governance, and information control belong to the community.
No cloud lock-in; no dependency on Qori Labs after handover.
Everyday vision for 2030
In a rural Andean community, a steward sends a short health alert by SMS. A family avoids a wasted trip. Another steward shares fair crop prices before market day. People balancing care responsibilities receive timely reminders about assemblies. All data stays local. All control rests with the community.
Appendix A: Example SMS flows
Subscribe
User: SALUD
System: Gracias. Recibirás alertas de [SALUD]. Tu código es 8392. Di STOP para salir.
Unsubscribe
User: STOP
System: Has salido de SALUD, PRECIO y COMUNIDAD. Gracias por usar Yachay Wasi.
Steward broadcast
yachay-wasi broadcast --topic salud --text "Enfermera visita mañana 8 a.m."
Appendix B: Current limitations and planned improvements
- Validation to date is lab-only; no live GSM or community deployment yet.
- Spanish command set; Quechua keywords and optional voice (IVR) support are planned based on community preference.
- All non-SMS transports from earlier exploration remain archived and disabled.
Closing
Information is dignity. Yachay Wasi provides a minimal, ethical, and ready-to-pilot way for communities to control and share critical information through the phones they already use—offline, with consent, and with privacy by design.