Home / Rulea / Rulea Specification
Rulea
Understand. Act. Comply.
Project Description
Rulea is an open-source AI compliance layer that can be integrated into any website, application, or platform to provide real-time Terms of Service guidance to users. Rather than relying on bans, suspensions, or unexplained moderation actions, Rulea empowers users with immediate explanations, recommendations, and educational guidance before a violation occurs.
Rulea acts as a universal compliance intermediary between users and platform policies, helping platforms reduce moderation friction while creating a more transparent and user-friendly experience.
Core Principles
- User empowerment over punishment
- Transparency over hidden moderation
- Education over enforcement
- Platform neutrality
- Explainable AI
- Privacy-first architecture
- Modular and extensible design
- Self-hostable and vendor-independent
Features
Real-Time Compliance Analysis
- Instant Terms of Service analysis
- Real-time content evaluation
- Submission validation before publishing
- Continuous compliance monitoring
- Low-latency conflict detection
- Context-aware recommendations
- Configurable confidence thresholds
Split-Screen Guidance Interface
- Original submission display
- AI explanation panel
- Clause highlighting
- Recommended corrections
- One-click revisions
- User education prompts
- Resubmission workflow
- Accessibility support
Explainable AI System
- Human-readable explanations
- Clause references
- Reasoning summaries
- Confidence indicators
- Multiple recommendation options
- Educational context
- Transparent decision-making
Terms of Service Intelligence
- Terms ingestion
- Policy parsing
- Clause extraction
- Semantic indexing
- Change detection
- Version tracking
- Historical policy comparisons
- Policy diff engine
- Automatic policy updates
Rule Engine
- Deterministic rules
- Custom platform rules
- Content restrictions
- Behavioral restrictions
- Geographic restrictions
- Age requirements
- Platform-specific policies
- Organization-specific rules
- Plugin-defined rules
AI Compliance Engine
- Large language model support
- Hybrid AI and rule processing
- Semantic understanding
- Context retention
- Recommendation generation
- Multi-step reasoning
- Risk scoring
- Compliance scoring
- User learning patterns
Multi-Language Support
- Multi-language policy parsing
- Localized recommendations
- Translation support
- International policy support
- Regional compliance handling
User Education System
- Interactive tutorials
- Policy explanations
- Learning prompts
- Educational recommendations
- Compliance history
- Personalized guidance
- Knowledge tracking
- Improvement suggestions
Analytics and Reporting
- Conflict trends
- Policy confusion analysis
- Recommendation success rates
- Platform insights
- User learning metrics
- Dashboard reporting
- Exportable reports
- Administrative analytics
Moderation Assistance
- Human review support
- Escalation recommendations
- False-positive reduction
- Moderation transparency
- Reviewer explanations
- Audit trails
Plugin Marketplace
- Community plugins
- Custom rule modules
- AI modules
- Theme packages
- Localization packs
- Legal reference packages
- Industry-specific modules
Privacy and Security
- Self-hosting support
- Local model support
- Data minimization
- Configurable retention
- Encryption support
- Access controls
- Audit logging
- Permission management
- Privacy-first architecture
Modular Architecture
Core Module
Responsibilities:
- Application orchestration
- Module management
- Configuration loading
- Dependency handling
- Event system
Directory:
/core
SDK Module
Responsibilities:
- Platform integrations
- Embeddable widgets
- Event communication
- Authentication
- Session handling
Directory:
/sdk
Submodules:
- Web SDK
- JavaScript SDK
- TypeScript SDK
- Mobile SDK
- React SDK
- Vue SDK
- API Client SDK
User Interface Module
Responsibilities:
- Split-screen interface
- Educational prompts
- User notifications
- Accessibility support
- Theme management
Directory:
/ui
Submodules:
- Split Panel
- Recommendation Panel
- Notification System
- Theme Engine
- Accessibility Components
Compliance Engine Module
Responsibilities:
- Policy evaluation
- Conflict detection
- Recommendation generation
- Risk analysis
Directory:
/compliance-engine
Submodules:
- Policy Evaluator
- Conflict Detector
- Recommendation Engine
- Risk Scoring System
AI Module
Responsibilities:
- LLM integrations
- Semantic analysis
- Explanations
- Recommendation generation
Directory:
/ai
Submodules:
- Language Models
- Embeddings
- Semantic Search
- Explanation Engine
- Recommendation Engine
Terms Parser Module
Responsibilities:
- Terms ingestion
- Clause extraction
- Version management
- Policy indexing
Directory:
/tos-parser
Submodules:
- Parser
- Indexer
- Version Tracker
- Diff Engine
Rule Engine Module
Responsibilities:
- Rule execution
- Policy enforcement
- Custom logic
- Plugin rules
Directory:
/rules
Submodules:
- Rule Runtime
- Policy Definitions
- Custom Rules
- Plugin Rules
Analytics Module
Responsibilities:
- Metrics
- Dashboards
- Reports
- Trend analysis
Directory:
/analytics
Submodules:
- Metrics Engine
- Reporting Engine
- Dashboard API
- Export Services
Security Module
Responsibilities:
- Authentication
- Authorization
- Encryption
- Audit logging
Directory:
/security
Submodules:
- Identity
- Permissions
- Encryption
- Audit Services
Integration Module
Responsibilities:
- Third-party integrations
- Webhooks
- APIs
- Event handling
Directory:
/integrations
Submodules:
- Webhooks
- API Gateway
- Event Bus
- Connectors
Marketplace Module
Responsibilities:
- Plugin installation
- Module discovery
- Package management
Directory:
/marketplace
Submodules:
- Plugin Registry
- Package Manager
- Extension Loader
Suggested Technology Stack
Frontend
- React
- Vue
- TypeScript
- Tailwind CSS
- Web Components
Backend
- Node.js
- Fastify
- Express
- GraphQL
- REST APIs
Databases
- PostgreSQL
- Redis
- Elasticsearch
AI and NLP
- OpenAI APIs
- Local LLMs
- Ollama
- spaCy
- Sentence Transformers
- Vector embeddings
Search and Retrieval
- Elasticsearch
- OpenSearch
- pgvector
Real-Time Communication
- WebSockets
- Server-Sent Events
- WebRTC
Infrastructure
- Docker
- Kubernetes
- NGINX
- Traefik
Observability
- Prometheus
- Grafana
- OpenTelemetry
Authentication
- OAuth2
- OpenID Connect
- SAML
- API Keys
Project Goals
- Make compliance understandable.
- Reduce unnecessary bans and suspensions.
- Increase transparency between users and platforms.
- Educate users before violations occur.
- Create a universal, open-source compliance standard.
- Provide an extensible framework that any platform can adopt.
Specification Branding License (SBL)
Standard
- Fully AGPL-3.0+ compliant system
- Copyleft enforced for network deployments
- Required attribution:
- Roxanne Ardary
- https://www.roxanneardary.com/
Optional
- Specification Branding License (SBL)
- Attribution-free commercial deployment
- Pricing based on scale, usage, and deployment scope
- https://roxanneardary.com/rulea/
License & Notice Requirements
Rulea is released under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).
By contributing to this project, you agree that your contributions will also be released under this license.
Please note the following:
- All contributions must comply with the AGPL-3.0+ terms.
- Under Section 7 of the license, all redistributions, forks, and derivative works must preserve attribution to Roxanne Ardary and roxanneardary.com.
- Rulea specifications are free to use with attribution. A Specification Branding License can be negotiated upon request.
- The project’s notice.md file tracks attribution requirements and contributor acknowledgments.
- Any update that adds new contributors or modifies attribution should also update
notice.md. - When submitting a pull request, ensure that any new files maintain the attribution headers where applicable.
- Network-deployed versions of this software must also remain fully AGPL-3.0+ compliant, including exposure of source code modifications when applicable under the license.
For full legal details, please refer to the AGPL-3.0+ license and the project’s notice.md file.
Notice – Rulea
Attribution Requirement: Under Section 7 of the AGPL 3.0+ license, all redistributions, forks, and derivative works, including network-deployed versions of this project, must provide attribution to Roxanne Ardary and roxanneardary.com.
Contributors
This file tracks contributors and their specific contributions to the project.
- Roxanne Ardary, roxanneardary.com – March 22, 2026
Created the repository for Rulea. Developed the core open-source AI compliance layer that empowers users with real-time Terms of Service guidance, hybrid AI + rule-based analysis, and split-screen recommendations to ensure transparent and fair compliance. - Add other contributors here – [Date]
[Describe contribution in one sentence]
License – Rulea
This repository is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).
Key Points
- You are free to use, modify, and distribute the code.
- All redistributions, forks, and derivative works or network-deployed versions must also be licensed under AGPL-3.0+ and provide attribution to Roxanne Ardary and roxanneardary.com as required under Section 7 of the license.
- The software is provided “as is,” without warranty of any kind.
For the full license text, see GNU AGPL-3.0 License.