Skip to content

evahteev/sol-atlas

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

SOL Atlas

Your Community Is Your Net Worth

The best crypto projects don't buy users β€” they build believers. SOL Atlas is a Telegram-native community platform that turns your group chats into thriving, gamified Web3 ecosystems.

Built on GURU Framework Telegram License: MIT


🌟 Why SOL Atlas?

The Problem: Web3 user acquisition costs ~$16,000 per user, and 90% are lost within weeks. Marketing burns millions while communities compound value.

The Reality: Top 3% of Web3 projects succeed because of community, not capital.

The Solution: SOL Atlas arms your groupchats with the tools to turn followers into loyal believers through gamified engagement, AI-powered onboarding, and cross-ecosystem connectivity.


⚑ Quick Start

Launch your Telegram community in under 5 minutes:

# Clone the repository
git clone https://github.com/dex-guru/sol-atlas
cd sol-atlas

# Run with Docker Compose
docker-compose up -d --build

Services:

πŸ“– Full Getting Started Guide β†’


🎯 What You Get

πŸ€– Telegram Bot Launchpad

Create your community hub instantly with pre-built templates:

  • Welcome flows & onboarding sequences
  • Quest systems & achievement tracking
  • Leaderboards & ranking mechanics
  • Wallet integration & token gating

🧩 Low-Code Quest Builder (BPMN)

Design custom quests, automations, and KPI-based missions without code:

  • Visual workflow designer powered by Camunda
  • Event-driven automation
  • Custom triggers & actions
  • Integration with Solana on-chain data

πŸ€– AI CoPilot Steward

Intelligent onboarding guide that helps new members:

  • Scenario-based learning flows
  • Natural language Q&A
  • Community navigation
  • Action recommendations

πŸ† Leaderboards & Cross-Community Chests

Connect users across the ecosystem:

  • Real-time ranking systems
  • Cross-project competitions
  • Shared reward pools
  • Network effects amplification

πŸ“Š Analytics & Knowledgebases

Track what matters:

  • Engagement rate & retention metrics
  • Sentiment analysis from Crypto Twitter
  • User behavior patterns
  • Community health scores

πŸ”— SOL Atlas Network

Discover, collaborate, and grow alongside other Solana builders:

  • Ecosystem directory
  • Cross-community events
  • Shared infrastructure
  • Collaborative growth

πŸ›‘οΈ Portable Community

Your data, your control:

  • Knowledge export/import
  • Wallet-linked accounts migrate with users
  • Protection against TON vendor lock
  • Multi-platform support

πŸ›οΈ Six Pillars of Community Success

SOL Atlas is built around the fundamental principles that make communities thrive:

  1. Connection β€” Real conversations, shared purpose, authentic relationships
  2. Identity β€” Roles, badges, and purpose-driven belonging
  3. Contribution β€” Quests and missions that drive meaningful participation
  4. Recognition β€” Rewards, ranks, and public celebration of achievements
  5. Growth β€” Viral referral loops and organic expansion
  6. Governance β€” From followers to stakeholders to DAO participants

πŸ“– Learn more about the Six Pillars β†’


πŸ› οΈ Technical Stack

Built on the GURU Framework β€” battle-tested infrastructure powering 30K+ MAU across multiple ecosystems:

  • Orchestration: Camunda BPMN for workflow automation
  • AI/ML: MindsDB for skilled agents & knowledge bases
  • Analytics: Redash for community insights
  • Blockchain: Solana Web3.js, Thirdweb for wallet integration
  • Bot Framework: Telegram Bot API with custom extensions
  • Frontend: Next.js for admin portals and dashboards
  • Data: PostgreSQL + Ethereum ETL patterns adapted for Solana

πŸ“– Architecture Deep Dive β†’


πŸ“¦ Project Structure

sol-atlas/
β”‚
β”œβ”€β”€ bot/                    # Telegram bot templates & launchers
β”‚   β”œβ”€β”€ luka_bot/          # Core bot implementation
β”‚   β”œβ”€β”€ ag_ui_gateway/     # Admin UI gateway
β”‚   └── flow_client/       # BPMN flow integration
β”‚
β”œβ”€β”€ worker/                # External workers for automation
β”‚   β”œβ”€β”€ common/            # Shared utilities
β”‚   β”œβ”€β”€ wallet/            # Wallet integration workers
β”‚   └── settings/          # Configuration management
β”‚
β”œβ”€β”€ engine/                # GURU Framework orchestration engine
β”‚   └── src/               # Camunda BPMN engine
β”‚
β”œβ”€β”€ docs/                  # Documentation
β”‚   β”œβ”€β”€ GETTING_STARTED.md
β”‚   β”œβ”€β”€ ARCHITECTURE.md
β”‚   β”œβ”€β”€ COMMUNITY_PILLARS.md
β”‚   β”œβ”€β”€ FEATURES.md
β”‚   └── INTEGRATIONS.md
β”‚
└── docker-compose.yaml    # One-command deployment

πŸš€ Use Cases

For Solana Builders

  • DeFi Projects: Gamify liquidity provision, staking, and governance participation
  • NFT Collections: Build engaged holder communities with quest-based utilities
  • DAOs: Automate contribution tracking and reputation systems
  • Launchpads: Create hype cycles with points farming and leaderboards
  • Infrastructure: Support developer communities with learning paths

Battle-Tested Examples

Project Description Community Size
Burning Meme Memecoin Launchpad on BASE 50K+ channel, 1K+ bot
DexGuru DeFi Aggregator (12 EVM Chains) 30K MAU, 5K+ bot
UCOIN Utility DEX with Quests 47K+ channel, 3K+ bot

πŸ’° The Market Opportunity

The Retention Goldmine:

Metric Without Atlas With Atlas Buddy
Avg CAC per user $16,000 Same (but retained)
Retention after 30 days 10% 50%+
Effective value retained $1,600 $8,000+ per user
Scaled across 1M users $1.6B $8B+ recovered value

Solana Scale:

  • ~3.7M daily active users
  • ~120M monthly active addresses
  • Even 1% retention gain = tens of millions in effective CAC savings

The next trillion-dollar opportunity in Web3 isn't acquisition β€” it's retention.


πŸŽ“ Documentation


🀝 Contributing

We welcome contributions from the community! Whether you're:

  • Building new bot templates
  • Creating quest patterns
  • Improving documentation
  • Fixing bugs
  • Adding integrations

Read the Contributing Guide β†’

Join our builders community: SOL Atlas Telegram


πŸ‘₯ Team

We've been there. Built it. Applied it.

  • Evgeny Vakhteev β€” CEO/CTO, Guru Network founder, ex-Disney Streaming
  • Alexey Geraskin β€” AI & Data Engineering wizard
  • Rodion Kharabet β€” Frontend legend behind DexGuru

Track Record:

  • DexGuru: $1B+ yearly volume (2022)
  • GURU Block Explorer: Hackathon winner 2023
  • Crypto Charts in Bloomberg Terminal
  • GURU Framework White Paper & Launch (2024)

🌐 Ecosystem

SOL Atlas is part of the broader GURU Network ecosystem:


Contributors ✨

Thanks goes to these wonderful people ❀:


πŸ“„ License

MIT License - see LICENSE file for details.


πŸ”— Links


🏁 Join the Atlas Network

Be among the top 3% who grow with their community, not against it.

Launch Your Bot β€’ Join Community β€’ Read Docs


From chat to community. From followers to believers. From noise to net worth.

About

Ship support that actually works.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 38.1%
  • TypeScript 28.8%
  • Java 10.3%
  • Kotlin 7.8%
  • MDX 5.0%
  • Go 3.9%
  • Other 6.1%