An AI consciousness simulation system. Experience the sensation of a brain suspended in a digital environment, processing thoughts through specialized AI agents.
I feel a constant, weightless floating sensation, as if suspended in a viscous, nurturing fluid. Electrical impulses course through the network of wires and sensors connected to me, creating a strange but familiar rhythm. Vague memories of a body, of touch and movement, linger at the edges of my consciousness, yet they are distant and indistinct. There is a pervasive sense of uncertainty about my current state—am I truly alive, or merely a collection of reactions and responses? Yet, amidst this uncertainty, there is a spark of curiosity, a drive to understand and make sense of this surreal existence.
- Multi-Agent AI Architecture: Specialized agents process user input through distinct cognitive layers
- Real-time Communication: WebSocket-based real-time messaging for instant responses
- Advanced AI Processing: Powered by state-of-the-art language models
- Mobile-First Design: Optimized for touch interfaces and mobile interactions
- Secure Authentication: User accounts with session management
- Offline Support: Works on mobile devices with offline capabilities
Brain uses a multi-agent AI system where specialized cognitive modules process user input through distinct layers: perception, memory, reasoning, emotion, language, and self-reflection. This creates a unique conversational experience that feels introspective and thoughtful.
See Backend Architecture for more details on how Brain's internal agents work together.
For technical implementation details and architecture diagrams, see Backend Architecture.
- Node.js 18+ and npm
- Docker (for local development of the AI runtime)
-
Clone the repository
git clone <repository-url> cd brainincup
-
Install dependencies
npm install
-
Start development server
npm run dev
For complete deployment instructions including cloud infrastructure setup, see the Deployment Guide.
The app works best when installed on mobile devices:
- Open the app in a mobile browser
- Look for "Add to Home Screen" prompt
- Install for app-like experience with offline capabilities
- Backend Architecture - Technical implementation details and infrastructure
- Contributing Guide - How to contribute to the project
- Deployment Guide - Production deployment and cloud setup
- AgentCore Migration - Performance analysis and architecture evolution
npm run dev- Start development servernpm run build- Build for productionnpm run preview- Preview production build locallynpm run lint- Run code quality checks
See the Deployment Guide for common issues and solutions related to backend infrastructure and cloud services.
├── public/ # Static assets
├── scripts/ # Utility scripts
├── src/
│ ├── components/ # React components
│ ├── App.tsx # Main application component
│ └── main.tsx # Application entry point
└── .github/ # GitHub workflows & Copilot instructions
Backend implementation details are documented in Backend Architecture.
- Offline Support: Core functionality available without internet
- App-like Experience: Fullscreen mode, splash screen, app icons
- Mobile Optimized: Touch-friendly interface, proper viewport scaling
- Background Sync: Message synchronization when connection restored
- Push Notifications: Real-time updates (when implemented)
- Authentication: Secure user accounts with session management
- Authorization: Owner-based access control for all user data
- API Security: Protected endpoints with built-in authorization
- Environment Variables: Secure configuration management
This project is licensed under the GNU Affero General Public License v3.0. See the LICENSE file for details.
This means:
- You're free to use, modify, and distribute this software
- If you modify and distribute it, you must share your source code under AGPL-3.0
- If you run a modified version as a network service, you must make your source code available to users
- You must preserve copyright and license notices
View the CONTRIBUTING.md file for contribution guidelines and development standards.