SutazAI is a comprehensive system for analyzing, maintaining, and generating code. It includes monitoring, maintenance, and deployment capabilities to ensure robust operation.
- Code analysis and quality checks
- Security scanning and vulnerability detection
- System monitoring and health checks
- Automated maintenance and optimization
- CI/CD pipeline integration
- Comprehensive logging and alerting
- Python 3.11+
- PostgreSQL 13+
- Node.js 16+ (for web UI)
- Systemd (for service management)
git clone https://github.com/yourusername/sutazai.git
cd sutazaipython -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activatepip install -r requirements.txtCreate a .env file in the project root:
DATABASE_URL=postgresql://sutazai:sutazai@localhost:5432/sutazai
SMTP_USER=your_smtp_user
SMTP_PASSWORD=your_smtp_passwordsudo ./scripts/install_services.shThe monitoring service runs automatically and provides:
- Resource usage monitoring (CPU, memory, disk)
- Service health checks
- Performance metrics collection
- Alert management
The maintenance service runs daily at 2:00 AM and performs:
- System optimization
- Security validation
- Dependency management
- Log rotation
- Backup management
Run code analysis manually:
python scripts/code_audit.pyDeploy to production:
python scripts/deploy.pypytestpylint .
mypy .
bandit -r .
safety checkThe repository includes pre-commit hooks for:
- Security scanning
- Code quality checks
- Type checking
Logs are stored in /opt/sutazaiapp/logs/:
monitoring.log: System monitoring logsmaintenance.log: Maintenance task logscode_audit.log: Code analysis logsdeploy.log: Deployment logs
Metrics are stored in /opt/sutazaiapp/metrics/ and include:
- Resource usage metrics
- Performance metrics
- Service health status
Alerts are sent via email when:
- Resource usage exceeds thresholds
- Services become unhealthy
- Critical issues are detected
- All services run under the
sutazaiapp_devuser - SSH keys required for deployment
- Environment variables for sensitive data
- Bandit for Python code security
- Safety for dependency security
- Regular security audits
- Fork the repository
- Create a feature branch
- Commit your changes
- Push to the branch
- Create a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
For support, please contact:
- Email: chrissuta01@gmail.com
- GitHub Issues: Project Issues
A comprehensive AI development platform featuring autonomous agents, model management, and advanced system integration.
/opt/sutazaiapp/
├── ai_agents/ # AI Agent implementations
│ ├── auto_gpt/ # AutoGPT agent
│ ├── configs/ # Agent configurations
│ └── schemas/ # JSON schemas for validation
├── model_management/ # Model lifecycle management
├── backend/ # Core backend services
├── web_ui/ # Frontend application
├── scripts/ # Utility scripts
├── packages/ # Custom packages
│ └── wheels/ # Python wheel files
├── logs/ # Application logs
├── doc_data/ # Documentation data
└── docs/ # Project documentation
- Create and activate virtual environment:
python3.11 -m venv venv
source venv/bin/activate- Install dependencies:
pip install --upgrade pip setuptools wheel
pip install -r requirements.txt- Configure environment:
- Copy
.env.exampleto.env - Update configuration values as needed
- Initialize directories:
mkdir -p logs doc_datapytest- Linting:
pylint backend/ ai_agents/ model_management/ - Type checking:
mypy . - Security scan:
bandit -r .
- API docs available at
/docsendpoint when running backend - Additional documentation in
/docsdirectory
- Base agent framework in
ai_agents/base_agent.py - AutoGPT implementation in
ai_agents/auto_gpt/ - Configuration management via JSON schemas
- FastAPI-based REST API
- Database migrations using Alembic
- Comprehensive error handling and logging
- Model versioning and deployment
- Performance monitoring
- Resource optimization
- All sensitive data must be stored in
.env - API keys and credentials never committed to repo
- Regular security audits with Bandit
- Input validation using Pydantic
- Fork the repository
- Create feature branch
- Make changes following style guide
- Add tests for new functionality
- Submit pull request
Copyright (c) 2024 SutazAI. All rights reserved.
Sutazaiapp is an advanced, offline-first AI development system designed to provide comprehensive code generation, management, and deployment capabilities.
- Code Server: 192.168.100.28
- Deployment Server: 192.168.100.100
- Owner: Florin Cristian Suta
- Phone: +48517716005
- Email: chrissuta01@gmail.com
-
AI Agents (
ai_agents/)- Integrates SuperAGI, AutoGPT
- Modular agent management system
-
Model Management (
model_management/)- Supports GPT4All, DeepSeek-Coder-33B
- Offline model handling
-
Backend (
backend/)- FastAPI-based services
- Strict security measures
- OTP-based external call authorization
-
Web UI (
web_ui/)- React frontend
- Responsive design
-
Deployment Scripts (
scripts/)- Automated deployment
- Rollback capabilities
- System configuration
- Python 3.11
- Ubuntu/Debian-based Linux
- Root access for initial setup
- Clone the repository
git clone https://github.com/chrissuta/sutazaiapp.git /opt/sutazaiapp- Run Setup Script
sudo bash /opt/sutazaiapp/scripts/setup_sutazaiapp.sh- OTP-based authorization
- Offline-first design
- Comprehensive code auditing
- Strict permission management
- Use
scripts/code_audit.shfor regular code quality checks - Commit changes to the appropriate module directory
- Run tests before deployment
Centralized logging available in logs/ directory
Comprehensive documentation located in docs/ directory
[To be determined - contact project owner]
Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.
SutazAI is an advanced, self-improving AI development platform designed to push the boundaries of artificial intelligence through comprehensive, secure, and autonomous systems.
- Dynamic component management
- Self-healing system architecture
- Intelligent resource allocation
- Centralized component coordination
-
Intelligent vulnerability scanning
-
Comprehensive dependency tracking
-
Automated update mechanisms
-
Dependency graph generation
-
Zero-trust network design
-
Multi-tier threat detection
-
Adaptive access control
- Real-time resource monitoring
- Predictive system health assessment
- Intelligent bottleneck detection
- Autonomous performance tuning
- Comprehensive system checkup
- Automatic syntax error fixing
- Dependency resolution
- Empty file detection
- Duplicate code identification
- System Orchestrator: Coordinates system-wide operations
- Dependency Manager: Advanced dependency tracking
- Performance Optimizer: Continuous system tuning
- System Integrator: Component discovery and synchronization
/opt/sutazaiapp/
├── ai_agents/
│ ├── superagi/
│ ├── auto_gpt/
│ ├── langchain_agents/
│ ├── tabbyml/
│ └── semgrep/
├── model_management/
│ ├── GPT4All/
│ ├── DeepSeek-Coder-33B/
│ └── ...
├── backend/
│ ├── main.py
│ ├── services/
│ ├── api_routes.py
│ └── ...
├── web_ui/
│ ├── package.json
│ ├── src/
│ └── ...
├── scripts/
│ ├── deploy.sh
│ ├── trigger_deploy.sh
│ ├── otp_override.py
│ ├── syntax_fixer.py
│ └── ...
├── packages/
│ ├── wheels/ (offline .whl files)
│ └── node/ (offline node modules)
├── logs/
├── doc_data/
└── docs/
- Zero-trust architecture
- Granular access control
- Continuous threat assessment
## 🚀 Performance Strategy
- Intelligent resource allocation
- Predictive scaling
- Real-time performance monitoring
- Autonomous optimization
## 📋 Prerequisites
### Hardware Requirements
- **CPU**: 8+ cores
- **RAM**: 32GB+
- **Storage**: 256GB SSD
- **OS**: Ubuntu 20.04+ LTS
### Software Requirements
- Python 3.11
- pip 23.3+
- Node.js 16+
## 🛠️ Installation
### 1. Clone Repository
```bash
git clone https://github.com/sutazai/sutazaiapp.git
cd sutazaiapp
python3 -m venv venv
source venv/bin/activatepip install --upgrade pip
pip install -r requirements.txtpython core_system/system_orchestrator.pypytest tests/- Unit Tests: 90%+
- Integration Tests: Comprehensive
- Performance Benchmarks: Included
- Centralized logging
- Real-time performance tracking
- Automated alerting
- Distributed tracing support
- Comprehensive error logging
- Performance profiling
- Autonomous error recovery
- Fork the repository
- Create feature branch
- Commit changes
- Push to branch
- Create pull request
Creator: Florin Cristian Suta
- Email: chrissuta01@gmail.com
- Phone: +48517716005
Proprietary - All Rights Reserved
Empowering Autonomous Intelligence
SutazAI includes powerful self-maintenance tools to ensure optimal system health:
Run a comprehensive system checkup to identify issues:
python system_checkup.pyThis tool checks for:
- Syntax errors in Python files
- Import errors and missing dependencies
- Empty files
- Duplicate code
- Uninstalled required packages
Automatically fix syntax errors in Python files:
python scripts/syntax_fixer.py <directory>To run a complete system repair that addresses all detected issues:
python fix_all_issues.pyThis script orchestrates multiple repair tools to fix:
- Syntax errors
- Import problems
- Dependency issues
- System configuration problems
- Performance bottlenecks
A Python 3.11 compatible application with advanced features.
- Python 3.11 or later
- Dependencies listed in requirements.txt
-
Clone the repository:
git clone https://github.com/sutazai/sutazaiapp.git cd sutazaiapp -
Create a virtual environment:
python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate -
Install dependencies:
pip install -r requirements.txt
Run the application:
# Project Development Guidelines
## Code Quality Standards
### Python Code
- We use `black` for code formatting
- `pylint` for static code analysis
- `mypy` for type checking
- `isort` for import sorting
### TypeScript/React Code
- ESLint for static code analysis
- Prettier for consistent code formatting
- TypeScript for type safety
## Development Setup
### Python Environment
1. Create a virtual environment:
```bash
python3.11 -m venv venv
source venv/bin/activate
-
Install development dependencies:
pip install -r requirements.txt pip install -r requirements-dev.txt
-
Run code quality checks:
black . pylint **/*.py mypy .
-
Install Node.js dependencies:
cd web_ui npm install -
Run code quality checks:
npm run lint npm run format
- Always run code quality checks before committing
- Write clear, descriptive commit messages
- Reference issue numbers when applicable
- All pull requests must pass automated code quality checks
- Maintain 80% test coverage for new code