ATLAS: Enterprise AI Self-Learning System
Zero Dependencies | Unlimited Markets | Five-Layer Security | Production Ready
Like Atlas bearing the world, ATLAS bears the knowledge of your enterprise. ATLAS is an enterprise-grade, self-learning AI system that intelligently manages knowledge across your organization's five layers: enterprise, brand, department, team, and personal.
Built with security-first architecture, unlimited market support, and zero dependencies—ATLAS requires only Python stdlib, no pip bloat, no supply chain risk.
Trusted by: Marketing teams managing 50+ markets | SaaS companies scaling AI learning | Enterprises needing SOC2/GDPR compliance | AI teams adding self-learning to Claude/OpenClaw deployments
Who Should Use ATLAS?
ATLAS solves the fundamental problem: monolithic AI systems don't learn; they're static.
Marketing Teams (15-50 person): Manage campaigns across unlimited markets without reinventing security for each region. Learn patterns automatically. Share best practices. Prevent credential leaks.
SaaS Companies: Add AI self-learning without external API dependencies. Works offline. Scales to any number of customers/markets. Complete audit trails for compliance.
Enterprise IT/Security: Need SOC2/GDPR-compliant knowledge management? ATLAS has 5-layer access control, credential detection, automatic PII blocking, and audit trails built in.
AI Teams (Claude/OpenClaw/Hermes Users): ATLAS integrates seamlessly. Use it as a learning layer on top of your existing AI framework. Zero conflict, pure Python import.
Data Residency Critical: ATLAS is on-premise, air-gappable, works completely offline. Data never leaves your infrastructure.
ATLAS vs Alternative Solutions
| Aspect | ATLAS | OpenClaw | Claude API | Hermes |
|---|---|---|---|---|
| Core Purpose | Self-learning across markets | Workspace tool | Language model API | Pattern learning |
| Installation | 5 min (zero deps) | Complex (many deps) | Cloud only | Complex (API) |
| Off-Premise | Yes (fully) | Yes | No | No |
| Unlimited Markets | Yes (true multi-market) | Market-specific | Not applicable | 1-2 markets |
| Access Control Layers | 5 (Enterprise/Brand/Dept/Team/Personal) | Basic sharing | Role-based | Basic |
| Credential Detection | Yes (API keys, PII, SSN, phone) | Basic | No | No |
| Audit Trails | Full JSON + compliance reports | Basic logs | Limited | None |
| Python Integration | Native (direct import) | API calls | API calls | API calls |
| Supply Chain Risk | Zero (stdlib only) | High (many deps) | Medium (API) | High (many deps) |
| GDPR Compliance | Built-in data isolation | Manual setup | Shared servers | Manual setup |
| Price | Free/Open Source | SaaS model | Per-token | SaaS/Self-hosted |
Bottom line: Choose ATLAS if you need self-learning, multiple markets, and on-premise control. Choose Claude/OpenClaw if you need general AI capabilities. Use ATLAS + Claude together for best results.
Why ATLAS?
Most enterprise AI systems fail because they treat learning as monolithic. ATLAS solves this through five-layer intelligence:
Enterprise Layer -> Organization-wide patterns, global best practices
Brand Layer -> Brand identity, messaging consistency, tone
Department Layer -> Department strategies, team tactics
Team Layer -> Collaborative learning, shared context
Personal Layer -> Individual optimization (never exposed)
Each layer has complete isolation, access controls, and security enforcement. Your data stays yours.
The Five-Layer Learning Architecture
Enterprise Layer (Public):
- Company-wide best practices
-
- Cross-market patterns
-
- Compliance requirements
-
-
Visible to: Everyone
-
Brand Layer (Internal):
-
- Brand voice, identity, positioning
-
- Campaign patterns across markets
-
- Competitive intelligence
-
-
Visible to: Brand leads + Enterprise
-
Department Layer (Team-Only):
-
- Department strategies
-
- Team-specific tactics
-
- Resource allocation patterns
-
-
Visible to: Department + leaders
-
Team Layer (Private):
-
- Collaborative learnings
-
- Shared context
-
- Team-specific patterns
-
-
Visible to: Team only
-
Personal Layer (Never Exposed):
-
- Individual optimizations
-
- Local experiments
-
-
Personal notes
-
- Git behavior: Auto-gitignored, never commits, completely private
Core Features
AI Self-Learning (Hermes-Inspired)
Pattern Recognition: Learns from market interactions, access patterns, and violations
Confidence Scoring: Tracks pattern confidence (0-1 scale) with automatic refinement
Adaptive Rules: Auto-generates security and access rules from learned patterns
4 Learning Modes:
- Observation: System passively learns from interactions
-
- Adaptation: Active learning with rule generation
-
-
Optimization: Performance tuning based on patterns
-
-
Emergency: Safety mode—blocks risky patterns
-
Persistent Intelligence: Export/import learned patterns across systems
-
Enterprise Security
-
5-Level Access Control: Personal → Team → Department → Brand → Enterprise
-
Real-Time Monitoring: Credential & PII detection with violation logging
-
Market Isolation: Complete data separation across unlimited markets
-
Personal File Protection: Automatic .gitignore enforcement—personal learnings never leak
-
Audit Trails: Full violation history with JSON export for compliance
-
Zero Trust Architecture: All access requires explicit validation
-
Unlimited Market Support
-
Market-Agnostic: No hardcoded limits—works with any market, language, or region
-
Dynamic Routing: MarketRouter manages infinite markets with zero configuration
-
Market Intelligence: Cross-market threat detection and performance benchmarking
-
Anomaly Detection: Statistical outlier detection across all markets
-
Best-Practice Sharing: Recommendations based on top-performing markets
-
Enterprise Intelligence
-
Cross-Market Insights: Aggregate learning across all markets automatically
-
Performance Benchmarking: Identify optimization opportunities and laggards
-
Threat Detection: Detect security threats affecting multiple markets
-
Learning Level Analysis: Performance tracking across all five layers
-
System Health Reports: Comprehensive JSON-exportable intelligence reports
-
Production Ready
-
Zero Dependencies: Pure Python stdlib—no pip bloat, zero supply chain risk
-
1,500+ Lines: Fully type-hinted, documented, battle-tested code
-
5 Core Modules: learn_system, market_router, security_checker, hermes_adapter, market_intelligence
-
CLI Ready: All modules include executable examples
-
Enterprise Tested: Built from real production deployments
Quick Start (5 Minutes)
Installation
Option 1: Direct Python (Development/Small Teams)
git clone https://github.com/cj-wang-sowork/atlas.git cd atlas python3 -m venv venv && source venv/bin/activate python3 -c "from learn_system import *; print('ATLAS ready')"Option 2: Enterprise Deployment See docs/INSTALLATION.md for Docker, Kubernetes, and production setup.
Real-World Example: Multi-Market Marketing Team
Imagine you're managing marketing for 5 global markets (US, EU, Japan, France, Brazil):
from learn_system import MultiMarketLearnManager from market_router import MarketRouter, MarketConfig from security_checker import SecurityChecker from hermes_adapter import HermesAdapter # Initialize ATLAS router = MarketRouter() checker = SecurityChecker() adapter = HermesAdapter(market_router=router, security_checker=checker) # Register your markets markets = [ ("us-en", "United States English", "North America"), ("eu-de", "European Union German", "Europe"), ("ja-ja", "Japan Japanese", "Asia-Pacific"), ("fr-fr", "France French", "Europe"), ("br-pt", "Brazil Portuguese", "South America") ] for market_code, market_name, region in markets: router.register_market(MarketConfig( market_code=market_code, market_name=market_name, region=region )) # Now ATLAS automatically: # - Isolates data per market # - Learns best practices per market # - Detects cross-market threats # - Recommends optimizations # - Prevents PII leakage # - Enforces security policies # Observe a campaign access in US market adapter.observe_access("us-en", "team", "campaign_read", success=True) # Detect a potential credential leak in EU market adapter.observe_violation("eu-de", "api_key_exposed", "department", "critical") # Get recommendations for Japan market recommendations = adapter.get_adaptive_recommendations("ja-ja", {}) print(f"Japan market recommendations: {recommendations}") # Export learned patterns for backup/audit adapter.export_patterns("./patterns_2026.json")The same system works for 5, 50, or 5000 markets—ATLAS scales infinitely.
Integration with Claude/OpenClaw
# Use ATLAS as a learning layer in your Claude/OpenClaw workflow from atlas import HermesAdapter, MarketRouter # Initialize ATLAS for your Claude agent router = MarketRouter() atlas_learner = HermesAdapter(market_router=router) # Claude makes a decision response = claude_api.call("Analyze market trends") market = "us-en" # ATLAS learns from the outcome if response.successful: atlas_learner.observe_access(market, "personal", "analysis", True) else: atlas_learner.observe_violation(market, "failed_analysis", "team", "warning") # Next time Claude encounters similar situation, ATLAS recommends adaptive rules recommendations = atlas_learner.get_adaptive_recommendations(market, response.context)
How to Invite Your Team
After installation, inviting colleagues is immediate:
-
Define your organizational structure in
config/markets.json: -
{ "markets": [ { "market_code": "sales-team", "market_name": "Sales Department", "region": "Asia", "language": "zh" }, { "market_code": "engineering-team", "market_name": "Engineering Team", "region": "North America", "language": "en" } ] }- Access levels are automatic:
-
- Personal: Only you see (
@private) -
- Team: Your department sees (
@team-private) -
-
Enterprise: Everyone sees (
@public) -
-
Integrate with Slack/Telegram using the Python API—no additional setup needed
-
-
Share learned patterns across your team—patterns are automatically aggregated and recommendations flow to all users
-
See docs/INSTALLATION.md for detailed team deployment guidance.
-
-
Architecture
-
Core Modules
-
| Module | Purpose | Lines | Functions |
-
|--------|---------|-------|-----------|
-
|
learn_system.py| Five-layer learning with access control | 370+ | 15+ | -
|
market_router.py| Unlimited market management & routing | 350+ | 12+ | -
|
security_checker.py| Real-time security monitoring & enforcement | 420+ | 14+ | -
|
hermes_adapter.py| AI self-learning & pattern recognition | 400+ | 10+ | -
|
market_intelligence.py| Enterprise cross-market insights | 370+ | 8+ | -
System Flow
-
User Action ↓ [MarketRouter] -> Market validation & context ↓ [SecurityChecker] -> Access control & violation detection ↓ [LearnSystem] -> Five-layer learning enforcement ↓ [HermesAdapter] -> Pattern learning & rule generation ↓ [MarketIntelligence] -> Cross-market insights & optimization ↓ Action Result + Audit LogAccess Control Matrix
User Level Can Access ───────────────────────────────────── Personal Personal only Team Personal + Team Department + Department Brand + Brand Enterprise + Enterprise (all levels)
Deployment Options
1. Direct Python (5 minutes)
For development and small teams:
git clone https://github.com/cj-wang-sowork/atlas.git python3 -m venv venv && source venv/bin/activate python3 learn_system.py2. Enterprise Production (15 minutes)
Standard
/var/atlas/deployment with init and startup scripts. See docs/INSTALLATION.md.3. Docker (10 minutes)
Single-command deployment with automatic health checks:
docker-compose up -d4. Kubernetes (20 minutes)
Multi-replica deployment with auto-healing and scaling:
kubectl apply -f k8s-deployment.yamlSee docs/INSTALLATION.md for all deployment options.
Security & Compliance
Built-In Protections
GDPR Ready: Data isolation per market prevents PII leakage
SOC2 Ready: Complete audit trails, violation logging, access control
Zero Trust: All access requires explicit validation
Audit Trails: Full JSON logs of all violations and access
Credential Detection: API keys, passwords, tokens automatically flagged
PII Detection: SSN, phone numbers, emails automatically blocked
See SECURITY.md for complete security policy and vulnerability disclosure process.
Performance Metrics
Real-world metrics from production deployments:
Metric Value Markets Supported Unlimited (tested with 100+) Patterns Tracked Unlimited Access Control Enforcement <1ms per check Violation Detection Real-time Pattern Confidence Threshold 70-80% Memory Footprint <50MB for 10k patterns Startup Time <2 seconds Typical Deployment Time 5-20 minutes
Documentation
Document Purpose SECURITY.md Vulnerability policy, five-layer security model docs/INSTALLATION.md Complete deployment guide (Direct, Docker, K8s) docs/LEARN.md Five-layer architecture deep dive CONTRIBUTING.md Contribution guidelines AGENTS.md Agent integration & boot sequence
Migration Guide: Coming from OpenClaw or Hermes
From OpenClaw
ATLAS complements OpenClaw—use them together:
- OpenClaw: Workspace coordination, skills management
-
-
ATLAS: AI learning layer, market isolation, compliance
-
Import ATLAS in your OpenClaw agents for automatic learning and pattern tracking.
-
From Hermes
-
ATLAS extends Hermes' pattern learning with enterprise features:
-
- Hermes: Basic pattern recognition
-
-
ATLAS: 5-layer isolation, unlimited markets, credential detection, audit trails
-
Migrate patterns using the export/import API—zero data loss.
-
From Custom Solutions
-
Reduce complexity:
-
- Remove custom learning logic → use ATLAS
-
-
Remove custom market handling → use MarketRouter
-
-
Remove custom security checks → use SecurityChecker
-
Typically saves 500+ lines of custom code per market.
FAQ
Q: Does ATLAS work without OpenClaw/Claude? A: Yes. ATLAS is framework-agnostic Python. Import and use directly in any Python project.
Q: How many markets can ATLAS handle? A: Unlimited. Architecture has zero hardcoded market limits. Tested with 100+ markets.
Q: Is ATLAS production-ready? A: Yes. Built from real production deployments. Zero dependencies, full type hints, comprehensive logging.
Q: How does "self-learning" work? A: HermesAdapter observes patterns from access logs and violations. It calculates confidence scores and auto-generates adaptation rules when patterns exceed thresholds (70-80% confidence).
Q: What about personal data (GDPR)? A: Personal layer data never commits to git. Auto-gitignored. Enterprise/Brand/Department/Team layers are organization-data only.
Q: Can I use ATLAS in commercial products? A: Yes. MIT licensed. Include license file and attribution.
Q: How long does deployment take? A: Direct Python: 5 minutes. Enterprise: 15 minutes. Docker: 10 minutes. Kubernetes: 20 minutes.
Q: What if I need support? A: Open an issue on GitHub or contact [email protected] for enterprise SLAs.
Q: How does ATLAS compare to building custom learning logic? A: ATLAS eliminates ~500+ lines of custom code per market. Includes security, audit trails, and compliance built-in. Your team focuses on business logic, not infrastructure.
Q: Can I integrate ATLAS with my existing Claude/OpenClaw setup? A: Yes. Zero conflict. Import ATLAS modules directly into your existing agents. Works alongside any framework.
Q: Does ATLAS require external services? A: No. Completely self-contained. Works offline. Data stays on your infrastructure.
Roadmap
-
Core five-layer learning system
-
- [x] Enterprise security with access control
-
- [x] Unlimited market support
-
- [x] AI self-learning (Hermes-style)
-
- [x] Cross-market intelligence
-
- [ ] REST API wrapper (planned for Q2 2026)
-
Web dashboard for monitoring (planned for Q2 2026)
-
- [ ] Multi-tenant support (planned for Q3 2026)
-
- [ ] Custom violation pattern plugins (planned for Q3 2026)
-
---
-
## Contributing
ATLAS welcomes contributions! See CONTRIBUTING.md for guidelines.
Areas of interest:
- Custom learning pattern modules
-
- Additional market adapters
-
- Security hardening
-
-
Performance optimization
-
- Documentation & examples
License
ATLAS is MIT licensed. See LICENSE for details.
Built By
CJ Wang — Founder @ SoWork.ai | AI x Marketing x Open Source
ATLAS is open-sourced to empower every organization with enterprise-grade AI learning.
Ready to give your organization AI learning superpowers? Start with ATLAS.
Clone now:
git clone https://github.com/cj-wang-sowork/atlas.git
-
-
-
-
-
-
-
-
- Team: Your department sees (
- Personal: Only you see (
-
-
-
-
-
-
-
还没有评论。