AI-Powered Smart Contract Security & Orchestration Platform
CyberAi is the central control plane for the decentralized AI ecosystem, providing contract registry, automated workflows, and security tools for blockchain applications.
# Clone the repository
git clone https://github.com/SolanaRemix/CyberAi.git
cd CyberAi
# Run bootstrap (installs dependencies, validates contracts, builds site)
./tools/bootstrap/bootstrap.sh
# Start development server
cd site && npm run devVisit cyberai.network for full documentation.
CyberAi/
├── contracts/ # Machine-readable contracts for ecosystem participants
│ ├── agents/ # AI agent contracts
│ ├── repos/ # Repository contracts
│ └── contract.schema.json
├── prompts/ # Operator-grade instruction prompts
│ ├── agents/ # Agent prompts
│ ├── operators/ # Operator prompts
│ ├── systems/ # System prompts
│ └── workflows/ # Workflow prompts
├── src/ # Core source code
│ ├── agents/ # Agent implementations
│ ├── contracts/ # Contract validation
│ ├── security/ # Security tools
│ └── utils/ # Shared utilities
├── tests/ # Test suites
│ ├── unit/ # Unit tests
│ └── integration/ # Integration tests
├── tools/ # Operational tools
│ ├── bootstrap/ # Bootstrap script
│ └── audit/ # Audit script
├── site/ # Main Astro site (cyberai.network)
│ └── src/
│ ├── pages/ # Documentation and site pages
│ └── layouts/ # Page layouts
├── docs/ # Documentation portal (🚧 Under Development)
├── app/ # Main application (🚧 Under Development)
├── dashboard/ # Dashboard interface (🚧 Under Development)
├── terminal/ # Terminal interface (🚧 Under Development)
├── smartbrain/ # SmartBrain AI (🚧 Under Development)
├── audit/ # Audit tools (🚧 Under Development)
├── api/ # API documentation (🚧 Under Development)
├── scripts/ # Build and automation scripts
└── .github/
├── workflows/ # CI/CD workflows
└── copilot/ # GitHub Copilot agent configuration
┌─────────────────────────────────────────────────────────────┐
│ CyberAi Platform │
│ cyberai.network (Main) │
└──────────────────────┬──────────────────────────────────────┘
│
┌───────────────┼───────────────┬──────────────┐
│ │ │ │
┌──────▼──────┐ ┌─────▼─────┐ ┌──────▼──────┐ ┌────▼─────┐
│ Documentation│ │ Dashboard │ │ Terminal │ │ API │
│ Portal │ │ Interface │ │ Interface │ │ Gateway │
└──────────────┘ └───────────┘ └─────────────┘ └──────────┘
docs.* dashboard.* terminal.* api.*
│ │ │ │
└───────────────┼───────────────┴──────────────┘
│
┌───────────────┼───────────────┬──────────────┐
│ │ │ │
┌──────▼──────┐ ┌─────▼─────┐ ┌──────▼──────┐ ┌────▼─────┐
│ SmartBrain │ │ Audit │ │ GitAntivirus│ │ Main │
│ AI │ │ Tools │ │ Scanner │ │ App │
└─────────────┘ └───────────┘ └─────────────┘ └──────────┘
smartbrain.* audit.* app.*
│ │ │ │
└───────────────┴───────────────┴──────────────┘
│
┌────────▼────────┐
│ Contract Layer │
│ ┌───────────┐ │
│ │ Agents │ │
│ ├───────────┤ │
│ │ Repos │ │
│ ├───────────┤ │
│ │ Runners │ │
│ └───────────┘ │
└─────────────────┘
Machine-readable contracts define capabilities, requirements, and metadata for:
- Agents: AI services for security audits, code analysis, and automation
- Repositories: Code repositories providing functionality
- Runners: Execution environments for agents
- Bootstrap: Verifies environment, installs dependencies, validates contracts, builds site
- Audit: Validates contracts, workflows, and site integrity
Static site powered by Astro, serving:
- Comprehensive documentation
- Contract browsing
- API reference
- Quickstart guides
- Node.js 18+
- npm or yarn
- Git
# Install dependencies
npm install
# Validate contracts
./tools/audit/audit.sh
# Build site
cd site
npm run build
# Preview site
npm run preview- Create contract JSON in
contracts/agents/orcontracts/repositories/ - Validate:
ajv validate -s contracts/contract.schema.json -d "contracts/agents/your-contract.json" --strict=false - Submit PR
See Contract Documentation for details.
CyberAi includes a comprehensive build system with multiple tools and configurations for various development and deployment scenarios.
- Makefile: Cross-platform automation with 30+ targets
- TypeScript Compiler (tsc): Primary build tool
- esbuild: Advanced bundling with tree-shaking and minification
- Turbo: Monorepo orchestration with intelligent caching
- Docker: Multi-stage containerization with optimization
# Using Makefile (recommended)
make help # Show all available targets
make build # Build the project
make test # Run tests
make quality # Run all quality checks
make ci # Full CI pipeline
# Using npm scripts
npm run build # Standard build
npm run build:advanced # Production build with optimization
npm run build:esbuild # Build with esbuild bundler
npm run docker:build # Build Docker image
npm run docker:up # Start Docker Compose services- Multi-platform builds: Linux, macOS, Windows
- Multiple Node.js versions: 18, 20, 21
- Build caching: Intelligent caching with Turbo
- Build verification: Automatic output validation
- Build information: Metadata generation (version, commit, timestamp)
- Quality gates: Integrated linting, type checking, and testing
For complete build system documentation, see BUILD.md.
CyberAi is deployed using GitHub Pages with automatic deployment on push to the main branch.
- Platform: GitHub Pages
- Domain: cyberai.network
- Build System: Astro static site generator
- Deployment: Automated via GitHub Actions
- Push changes to the main branch
- GitHub Actions automatically builds the site
- Site is deployed to GitHub Pages
- Changes are live at cyberai.network
This project has been fully migrated from Vercel to GitHub Pages. A vercel.json configuration file is included to disable Vercel builds and prevent deployment conflicts.
If you're experiencing issues migrating from Vercel, use our diagnostic tool:
# Run the Vercel issue scanner
bash tools/vercel-scanner.shThis tool will:
- Check for Vercel configuration files
- Identify Vercel-specific dependencies
- Verify GitHub Pages setup
- Provide migration guidance
Note: The vercel.json file explicitly disables Vercel deployments. If the Vercel GitHub App is still connected to your repository, it will see this configuration and skip builds.
See CONTRIBUTING.md for contribution guidelines.
See SECURITY.md for security policies and vulnerability reporting.
Licensed under the Apache 2.0 License. See LICENSE for details.
- Website: cyberai.network
- GitHub: SolanaRemix/CyberAi
- Documentation: cyberai.network/docs
Built with ❤️ by the CyberAi community