This repository contains a fully-featured AI-powered Web3 website with modern authentication, AI models, smart contracts, and cloud deployment.
Features
Frontend: React.js / Next.js with Tailwind CSS
Backend: FastAPI (Python) & Express.js (Node.js)
Authentication: SAML, OAuth2, JWT
Web3 Integration: Solidity smart contracts, The Graph, Oracles
AI Models: Hugging Face, TensorFlow-Serving, PyTorch
Messaging & Streaming: Kafka with Zookeeper
Database: PostgreSQL, MongoDB, Redis, IPFS
DevOps & Deployment: Docker, Kubernetes, Terraform, CI/CD with GitHub Actions
Monitoring & Logging: Prometheus, Grafana, Loki, ELK Stack
TecX.AI/
│── frontend/ # React.js / Next.js frontend
│ ├── public/ # Static assets (e.g., images, favicon, static HTML files)
│ │ ├── index.html # Static fallback homepage (for non-Next.js builds)
│ ├── src/
│ │ ├── components/ # Reusable UI components
│ │ │ ├── Navbar.js
│ │ │ ├── Footer.js
│ │ │ ├── Button.js
│ │ ├── pages/ # Next.js pages
│ │ │ ├── index.js # Homepage entry point for Next.js
│ │ │ ├── login.js # Login page
│ │ │ ├── dashboard.js # User dashboard
│ │ ├── styles/ # Tailwind CSS styles
│ │ │ ├── globals.css
│ │ │ ├── theme.css
│ │ ├── utils/ # Helper functions
│ │ │ ├── api.js # API calls
│ │ │ ├── format.js # Formatting utilities
│ │ ├── web3/ # Web3 integrations (MetaMask, WalletConnect, The Graph, Oracles)
│ │ │ ├── provider.js
│ │ │ ├── connectWallet.js
│ │ ├── hooks/ # Custom React hooks
│ │ │ ├── useAuth.js
│ │ │ ├── useWeb3.js
│── backend/ # API layer
│ ├── fastapi/ # FastAPI microservices
│ │ ├── main.py
│ │ ├── routes/
│ │ │ ├── user.py
│ │ │ ├── auth.py
│ │ ├── models.py
│ ├── express/ # Express.js microservices
│ │ ├── index.js
│ │ ├── routes/
│ │ │ ├── user.js
│ │ │ ├── auth.js
│ ├── authentication/ # SAML, OAuth2, JWT authentication
│ │ ├── auth.js
│ │ ├── samlConfig.js
│ ├── websocket/ # Real-time WebSocket services
│ │ ├── server.js
│ ├── ai_models/ # AI Model Deployment (Hugging Face, TF-Serving, PyTorch, NLP, Computer Vision)
│ │ ├── model.py
│ │ ├── inference.py
│ ├── logging/ # Centralized logging (ELK Stack, Loki, Fluentd)
│── web3/ # Smart contracts and blockchain logic
│ ├── contracts/ # Solidity smart contracts
│ │ ├── Contract.sol
│ ├── scripts/ # Deployment and interaction scripts
│ │ ├── deploy.js
│ ├── test/ # Smart contract testing (Slither, Mythril)
│ │ ├── contract.test.js
│ ├── security/ # Security audits and vulnerability scanning
│ ├── subgraphs/ # The Graph integration for indexing
│── database/ # Database and storage
│ ├── sql/ # PostgreSQL schemas
│ │ ├── schema.sql
│ ├── nosql/ # MongoDB models
│ │ ├── userModel.js
│ ├── redis/ # Redis caching
│ │ ├── cache.js
│ ├── ipfs/ # IPFS & Arweave storage
│── devops/ # Deployment and automation
│ ├── docker/ # Dockerfiles for containerization
│ │ ├── Dockerfile
│ ├── kubernetes/ # K8s configurations for container orchestration
│ │ ├── deployment.yaml
│ │ ├── service.yaml
│ ├── terraform/ # Infrastructure as Code (IaC) using Terraform
│ │ ├── main.tf
│ ├── ci-cd/ # GitHub Actions, Jenkins pipelines
│ │ ├── github-actions.yml
│ ├── security/ # Security monitoring and vulnerability scanning
│ ├── monitoring/ # Monitoring (Prometheus, Grafana, Loki)
│ │ ├── prometheus.yaml
│ │ ├── grafana.yaml
│ ├── kafka-zookeeper/ # Kafka message broker and Zookeeper coordination service
│ │ ├── kafka-config.yaml
│ │ ├── producer.py
│ │ ├── consumer.py
│ ├── load-balancer/ # Nginx, HAProxy for traffic management
│ │ ├── nginx.conf
│── ai-engine/ # AI Pipelines and Training
│ ├── models/ # Pretrained AI models and training data
│ ├── training/ # Scripts for AI model training and fine-tuning
│ │ ├── train.py
│ ├── inference/ # AI inference API for real-time predictions
│ │ ├── infer.py
│ ├── pipelines/ # Data processing pipelines
│ │ ├── preprocess.py
│ ├── notebooks/ # Jupyter notebooks for research and development
│ │ ├── model_exploration.ipynb
│ ├── requirements.txt # Dependencies for AI model execution
│── tests/ # Testing
│ ├── unit-tests/ # Unit testing for all modules
│ ├── integration-tests/ # API and full-system tests
│ ├── load-tests/ # Performance and stress testing
│ ├── security-tests/ # Security and vulnerability testing
│── scripts/ # Deployment & automation
│ ├── deploy.sh # Automated deployment script
│ ├── backup/ # Database backup and restore scripts
│── docs/ # Documentation
│── .gitignore # Ignore files
│── README.md # Project overvie
## 🚀 Getting Started
### Prerequisites
- Node.js & npm
- Python 3.x
- Docker & Kubernetes
- MetaMask (for Web3 integration)
- Hardhat (for smart contract deployment)
- PostgreSQL or MongoDB (database setup)
📌 Setup Instructions
1️⃣ Clone the Repository
### Installation
Clone the repository and navigate into the project folder:
```sh
git clone https://github.com/TecExpo/TecX.AI.git
cd TecX.AI
2️⃣ Install Dependencies
Frontend (React.js / Next.js)
Navigate to the frontend directory and start the development server:
cd frontend
npm install
npm run devBackend (FastAPI / Express.js)
Navigate to the backend directory and run the servers:
cd backend
pip install -r requirements.txt # FastAPI
# Start FastAPI server
uvicorn fastapi.main:app --reload
# Start Express.js server
npm install # Express.js
node server.js3️⃣ Configure Environment Variables
Create a .env file in backend/ and frontend/ with required API keys and settings.
4️⃣ Start Services
Using Docker docker-compose up --build
Manually
cd frontend && npm run dev # Start frontend cd backend/fastapi && uvicorn main:app --reload # Start FastAPI cd backend/express && node index.js # Start Express.js
5️⃣ Deploy Smart Contracts
Compile and deploy the smart contracts using Hardhat:
cd web3
npx hardhat compile
npx hardhat run scripts/deploy.js --network rinkebyStart the database services using Docker:
docker-compose up -dEnsure you configure your .env file with the correct database credentials.
The repository includes a CI/CD pipeline using GitHub Actions. Push changes to the main branch, and the deployment will be triggered automatically.
- Frontend: React.js, Next.js, Tailwind CSS, Web3.js
- Backend: FastAPI (Python), Express.js (Node.js), WebSockets
- AI: Hugging Face, TensorFlow, PyTorch, NLP, OpenAI APIs
- Web3: Solidity, Hardhat, MetaMask, The Graph, Ethers.js, IPFS, Arweave
- Database: PostgreSQL, MongoDB, Redis, IPFS
- DevOps: Docker, Kubernetes, Terraform, CI/CD(GitHub Actions, Jenkins)
- Authentication: Implements SAML, OAuth2, and JWT-based authentication.
- Smart Contract Audits: Use OpenZeppelin for security best practices.
- Data Encryption: Sensitive data is encrypted using industry standards.
- Environment Variables: Ensure API keys and secrets are stored securely.
We welcome contributions! Please do as following
- Fork the repository and create a new branch(feature).
- Make changes and commit with meaningful messages.
- Submit a pull request for review.
- Follow coding best practices and security guidelines.
This project is licensed under the GNU GPL and, MIT License. See LICENSE for details.
For any inquiries, issues or questions, please open an issue on GitHub or contact the maintainers at [email protected]',or '[email protected].
This Document provides a complete overview of the AI Web3 Website repository, including setup instructions, technology stack, security considerations, and contribution guidelines.