-
Notifications
You must be signed in to change notification settings - Fork 0
Home
Aletheia (Greek: ἀλήθεια) — "truth" or "disclosure" — the state of not being hidden.
Aletheia is an AI-powered browser extension that reveals the hidden history behind everyday language. Select text on any webpage, right-click "Explain with AI", and get etymology-rich analysis powered by a privacy-first serverless backend.
Try it → | View Source | Privacy Policy
You shouldn't have to choose between useful AI tools and your privacy. Aletheia was built with 7 security layers, minimal browser permissions, and a 30-day data retention policy. We never sell data, we anonymize logs, and AWS Bedrock guarantees your text is never used for model training.
- Privacy Policy — What we collect, how long we keep it, your rights
- Security Architecture — 7 layers from browser to database
- FAQ: Privacy & Security — Plain-language answers
- 20 Architecture Decision Records — Every security choice documented with rationale
Aletheia's context engine can enhance reader engagement for digital publishers. The architecture is designed for white-label integration: a stateless Lambda backend, configurable rate limiting, and tenant-aware authentication.
- Architecture — CloudFlare → Lambda → Bedrock pipeline
- API Reference — RESTful endpoints for analysis, auth, billing, admin
- Security — Enterprise-grade defense in depth with documented ADRs
- Developer Guide — 975+ tests, 12 pre-commit hooks, CI/CD pipeline
This project demonstrates production-grade engineering across the full stack: browser extension development (MV3), serverless architecture (Lambda + DynamoDB), edge computing (CloudFlare Workers), OAuth + JWT authentication, Stripe billing integration, and AI orchestration (LangGraph + Bedrock). Built using an AI-as-Workforce methodology with multi-agent orchestration and adversarial code review.
- Architecture — System design with C4 diagrams and data flow
- ADRs — 20 architecture decision records showing design thinking
- Security — Defense in depth across 7 layers
- Developer Guide — Test infrastructure, CI pipeline, code quality
| Section | Description |
|---|---|
| Getting Started | Installation and first steps |
| User Guide | How to use Aletheia |
| Architecture | Technical system design |
| Developer Guide | Contributing and development |
| API Reference | Backend API documentation |
| Security | Security policy and practices |
| Privacy | Privacy policy |
| FAQ | Frequently asked questions |
- Etymology Analysis — Understand the origins and evolution of words
- Context-Aware — Considers the surrounding text for disambiguation
- Privacy-First — Minimal permissions, anonymized logging, no browsing history access
- Multi-Browser — Supports Chrome (Manifest V3) and Firefox (Manifest V2)
- Educational Focus — Designed to inform, not judge
- JWT Authentication — LinkedIn OAuth sign-in with sub-millisecond local validation
- Tiered Subscriptions — Free tier with generous limits, premium via Stripe
- Rate Limiting — Per-user multi-window caps (hourly, daily, monthly)
- Admin Dashboard — CloudWatch metrics, subscription management, ID resolution tools
- Select text on any webpage
- Right-click and choose "Explain with AI"
-
View the analysis in an overlay showing:
- Signal indicator (educational context level)
- Etymology gem (key historical insight)
- Full context explanation
| Layer | Technology |
|---|---|
| Frontend | Browser Extension (JavaScript) |
| Edge | CloudFlare Workers (rate limiting, DDoS protection) |
| Backend | AWS Lambda (Python 3.12) — Agent + Auth |
| AI | AWS Bedrock (Anthropic Claude) |
| State | AWS DynamoDB (agent state, users, token cap, coupons) |
| Auth | LinkedIn OAuth → JWT (HS256) → Secrets Manager |
| Billing | Stripe (subscriptions, webhooks, checkout) |
| Observability | CloudWatch (EMF metrics, X-Ray, 14-day retention) |
Aletheia is in active development, targeting Chrome Web Store and Firefox Add-ons publication.
| Milestone | Status |
|---|---|
| Core Extension | ✅ Complete |
| AWS Backend | ✅ Complete |
| Digital Etymologist | ✅ Complete |
| Security Hardening | ✅ Complete |
| CloudFlare Migration | ✅ Complete |
| LinkedIn OAuth | ✅ Complete |
| JWT Authentication | ✅ Complete |
| Tiered Rate Limiting | ✅ Complete |
| Stripe Billing | ✅ Complete |
| Observability (CloudWatch + Alerting) | ✅ Complete |
| Admin Dashboard | ✅ Complete |
| Store Submission | 🔄 In Progress |
Aletheia is open source under the MIT License.
Built by Marty McEnroe using the AI-as-Workforce development paradigm.
Last updated: 2026-02-19
Aletheia — AI-Powered Context Analysis | MIT License | Report Security Issue
Wiki verified: 2026-02-19