AIverse is a beautiful, immersive web application that transforms how you create and interact with AI agents. Built with Next.js and Tailwind CSS, it features a stunning cosmic interface with a galaxy-style marketplace where you can browse, create, and deploy intelligent AI agents. Whether you're building custom agents to automate tasks, exploring community-created agents, or learning best practices in agent development, stellAIverse provides an intuitive platform with a visual experience that feels like exploring the stars.
The platform combines a powerful agent creation wizard (describe behavior → auto-generate basic contract + metadata), an interactive chat interface for agent interaction, a portfolio dashboard with performance stats, and an educational mode with tutorials on building smarter agents—all wrapped in a captivating cosmic UI theme with dark space backgrounds, glowing nebulae, and animated star constellations.
- 🧙 Agent Creation Wizard: Describe your agent's behavior and automatically generate basic contracts + metadata
- 🌌 Galaxy Marketplace: Browse and discover agents visualized as stars and planets
- 💬 Agent Chat Interface: Interact with your AI agents in real-time
- 📊 Agent Portfolio: Track your owned agents and view detailed performance statistics
- 📈 System & Business Dashboard: Prometheus/OpenTelemetry-compatible metrics with filtering and CSV export (PII-safe)
- 🎓 Educational Mode: Learn best practices and tutorials for building smarter agents
- ✨ Cosmic UI Theme: Dark space aesthetic with glowing nebulae and animated constellations
- 📱 Progressive Web App: Installable app with offline support and aggressive caching
- ⚡ Lightning Fast: Advanced caching strategies for instant load times
- 🔄 Background Sync: Sync data when connection is restored
- 🔔 Push Notifications: Real-time updates and engagement features
- Node.js: v18 or higher
- npm or yarn: Package manager
- Git: Version control
git clone https://github.com/StellAIverse/stellAIverse-frontend.git
cd stellAIverse-frontendUsing npm:
npm installOr using yarn:
yarn installCreate a .env.local file in the root directory with the necessary environment variables:
cp .env.example .env.local # if available, or create manuallyAdd the following (adjust based on your backend configuration):
NEXT_PUBLIC_API_URL=http://localhost:3001
NEXT_PUBLIC_ENVIRONMENT=development
npm run devThe application will be available at http://localhost:3000
npm run buildnpm run testFor Progressive Web App features with aggressive caching:
# Quick PWA setup
chmod +x scripts/setup-pwa.sh
./scripts/setup-pwa.sh
# Or manual setup
npm install next-pwa workbox-webpack-plugin
node scripts/generate-icons.js
npm run buildIf running with a local backend, ensure:
- Frontend runs on
http://localhost:3000 - Backend API runs on the configured
NEXT_PUBLIC_API_URL - CORS is properly configured if frontend and backend are on different domains
stellAIverse-frontend/
├── app/ # Next.js app directory
├── components/ # React components
├── lib/ # Utility functions and helpers
├── styles/ # Global styles and Tailwind config
├── public/ # Static assets
├── .env.example # Environment variables template
└── package.json # Dependencies and scripts
- Documentation - Detailed guides and API documentation
- PWA Implementation Guide - Progressive Web App features and caching strategies
- Metrics dashboard - Prometheus/OpenTelemetry integration and PII policy
- Contributing Guidelines - How to contribute to the project
- Issues - Report bugs or request features
- Discussions - Community discussions
- Next.js Documentation - Learn about Next.js
- Tailwind CSS Documentation - Style reference
This project is licensed under the MIT License. See the LICENSE file for details.