diff --git a/README.md b/README.md index ca4d828..b16dbaf 100644 --- a/README.md +++ b/README.md @@ -1,226 +1,150 @@ -# AI-Powered Trading Platform +# PulseTrade: AI-Powered Trading Platform πŸš€ -Welcome to the **AI-Powered Trading Platform** repository! This platform combines cutting-edge AI capabilities, blockchain technology, and seamless integration to deliver a state-of-the-art trading experience. It is designed to empower both individual traders and trade administrators to maximize profits, manage accounts efficiently, and execute trades with real-time intelligence. +## Project Overview ---- - -## Key Features - -1. **AI-Driven Trading Assistance** - - - Automated trade execution with real-time decision-making. - - Trade signal generation for manual approval or autonomous operation. - - Configurable AI settings for risk tolerance and trade size. - - Portfolio management with AI-based suggestions for diversification and optimization. - - Trade signal suggestions based on technical, fundamental, and sentiment analysis. - - Updates on market news and trends across stocks, forex, and crypto assets. - -2. **Trade Admin Features** - - - Sub-account management with virtual balances to prevent direct fund access. - - Profit-sharing mechanisms with blockchain-based smart contracts. - - Aggregated portfolio views for all managed accounts. - - AI-assisted sub-account trading and management. - -3. **User Types** - - - **Regular Users**: Beginner, intermediate, and pro traders leveraging AI and platform tools for trading. - - **Trade Admins**: Manage sub-accounts, use AI to optimize multiple portfolios, and earn profit shares. - -4. **Blockchain Integration** - - - Smart contracts for profit sharing and virtual balance management. - - Decentralized wallet connectivity with support for MetaMask and StarkNet's Argent Wallet. - -5. **Rich Analytics and Reporting** - - - Performance insights with charts and metrics. - - Comparative analysis of AI-driven vs. manual trades. - -6. **Learning and Rewards** - - Tutorials for beginner traders as Koii tasks, rewarding users with platform tokens upon completion. - - Tokens created on Koii are used to incentivize engagement and learning. - ---- - -## Technologies Used - -### **Core Technologies** - -- **Particle**: Ensures seamless interaction with blockchain networks for executing trades and smart contract functionalities. -- **iExec**: Provides decentralized computing power for AI model execution, data sharing, and secure data access through Data Protectors and Web3Mail. -- **Spectral**: Enhances risk assessment by analyzing user creditworthiness for trading decisions. -- **Citrea**: Manages complex workflows, ensuring AI and user actions are synchronized effectively. -- **Koii**: Facilitates decentralized content validation and distribution for learning modules and rewards with platform tokens. -- **StarkNet**: Offers scalable and secure Layer 2 solutions for faster blockchain interactions, supporting smart contracts for specific services like profit sharing. - -### **Frontend** - -- **Next.js**: For building a responsive and dynamic user interface. -- **Chart.js**: For visualizing trade data and performance metrics. -- **Tailwind CSS**: For a consistent and modern design system. - -### **Backend** +PulseTrade is a cutting-edge, AI-driven trading platform that combines advanced machine learning, blockchain technology, and decentralized finance to revolutionize trading experiences. The platform empowers traders of all levels with intelligent trade recommendations, secure transactions, and comprehensive portfolio management. -- **Node.js**: Provides APIs for communication between the frontend and services. -- **Express.js**: Powers the RESTful API endpoints. -- **WebSockets**: For real-time notifications and updates. +### Key Features 🌟 -### **AI Engine** +- **AI-Powered Trading Insights** + - Real-time trade signal generation + - Multi-model AI analysis (technical, fundamental, sentiment) + - Customizable risk management + - Cross-asset support (stocks, crypto, forex) -- **Open Source LLMs**: - - **GPT-J**: Handles natural language understanding for sentiment analysis and trade-related news. It analyzes market trends, social media sentiments, and financial news to influence trading decisions. - - **Falcon**: Focuses on technical data analysis and trade signal generation. It processes technical indicators like moving averages, RSI, and MACD to create actionable trade signals. - - **LLaMA**: Synthesizes technical, fundamental, and sentiment data to generate a final trade recommendation. This model integrates inputs from both Falcon’s technical analysis and GPT-J’s sentiment insights for holistic decision-making. -- **AI Functionality**: - - Technical analysis of trading indicators (e.g., RSI, MACD, moving averages). - - Fundamental analysis, including earnings reports and economic data. - - Sentiment analysis using news and social media trends. - - Dynamic trade signal generation tailored to user profiles (e.g., beginner, intermediate, pro). +- **Decentralized Architecture** + - Blockchain-secured transactions + - Smart contract-based profit sharing + - Multi-wallet support (MetaMask, Argent) -### **Blockchain** +- **User-Centric Design** + - Intuitive dashboard + - Performance analytics + - Learning modules with rewards -- **Ethereum/Polygon**: For deploying general smart contracts that handle profit sharing and virtual balances. -- **StarkNet**: Used specifically for faster, secure Layer 2 smart contracts, including those for trust agreements and trade-related services. -- **Web3.js**: Facilitates interactions between the app and blockchain networks. -- **Wallet Integration**: - - **MetaMask**: Standard wallet for Ethereum-based interactions. - - **Argent Wallet**: A StarkNet-compatible wallet for decentralized transactions, providing an additional layer of scalability and security for StarkNet-based interactions. +## Technologies Used πŸ’» -### **Database** +### Frontend +- Next.js 14 +- React 18 +- Tailwind CSS +- Radix UI Components -- **PostgreSQL**: For storing user data, trade history, and performance metrics. -- **Redis**: For caching frequently accessed data, such as live trade signals. +### Blockchain & Web3 +- Ethereum +- StarkNet +- Particle Network +- Web3.js +- ethers.js -### **DevOps and Deployment** +### AI & Machine Learning +- Open-source LLMs (GPT-J, Falcon, LLaMA) +- AI-driven trade signal generation +- Sentiment and technical analysis -- **Docker**: For containerizing application components. -- **Kubernetes**: For orchestrating containers in a scalable way. -- **AWS/GCP**: Cloud hosting for frontend, backend, and AI services. +### Additional Services +- Firebase (Authentication) +- iExec (Decentralized Computing) +- Koii Network (Decentralized Tasks) ---- - -## System Architecture - -### **Workflow Overview** - -1. **User Registration & Onboarding**: - - Users create accounts, configure AI settings, and link wallets (MetaMask/Argent). -2. **AI-Driven Operations**: - - - AI analyzes market data and generates trade signals. - - Signals are sent to users for approval or executed autonomously. - -3. **Trade Execution**: - - - Trades initiated by AI or users are executed via integrated APIs and reflected on the platform dashboard. - -4. **Profit Sharing**: - - - Smart contracts ensure automatic profit distribution between trade admins and sub-accounts. - - Virtual balances are updated after each trade. - -5. **Analytics & Reporting**: - - - Users view performance metrics, trade history, and profit/loss reports. - - Admins monitor sub-account activities and overall portfolio performance. +## Getting Started πŸš€ -6. **Learning and Rewards**: - - Tutorials on Koii educate beginners about trading strategies. - - Completing tasks rewards users with platform tokens. - -### **Integration Overview** - -| Component | Technology | Functionality | -| -------------- | ------------------------------------------------- | ---------------------------------------------------------- | -| **Frontend** | Next.js, Chart.js | User interface, dashboards, and data visualization. | -| **Backend** | Node.js, Express | API management, user authentication, and trade sync logic. | -| **AI Engine** | GPT-J, Falcon, LLaMA | Multi-LLM collaboration for trade insights and decisions. | -| **Blockchain** | Solidity, Web3.js | Smart contracts for profit sharing and virtual balances. | -| **Database** | PostgreSQL, Redis | Persistent and cached data storage. | -| **DevOps** | Docker, Kubernetes | Scalable deployment and container orchestration. | -| **Core Tech** | Particle, iExec, Spectral, Citrea, Koii, StarkNet | Decentralized workflows, risk assessment, and performance. | - ---- +### Prerequisites +- Node.js 18+ +- npm 9+ +- Ethereum-compatible wallet ---- +### Installation Steps -## Smart Contracts Overview +1. Clone the repository +```bash +git clone https://github.com/YourUsername/pulsetrade.git +cd pulsetrade +``` -The following table outlines the smart contracts required for the platform, their deployment platforms, and functionality: +2. Install dependencies +```bash +npm install +``` -| **Contract Name** | **Platform** | **Purpose** | -| ------------------------------ | ------------------- | --------------------------------------------------------------------------------------------- | -| User Management Contract | Ethereum (Solidity) | Manage users, roles, and wallet connections. | -| Profit-Sharing Contract | Ethereum (Solidity) | Handle profit distribution between trade admins and sub-accounts. | -| Token Contract | Ethereum (Solidity) | Manage platform tokens for rewards and transactions. | -| Reward Distribution Contract | Ethereum (Solidity) | Incentivize users for completing tasks (can merge with token contract). | -| Trade Execution Contract | Ethereum (Solidity) | Record trade details and ensure transparency. | -| Virtual Balance Contract | Ethereum (Solidity) | Manage virtual balances for trade admins and sub-accounts. | -| Data Protection Contract | iExec (Off-chain) | Store encrypted data references and enable secure communication via iExec. | -| Workflow Management Contract | StarkNet (Cairo) | Facilitates task orchestration and manages AI-driven or user-driven workflows through Citrea. | -| Wallet Compatibility Contracts | Ethereum, StarkNet | Support MetaMask and StarkNet Argent wallets for decentralized transactions. | +3. Configure environment variables +```bash +cp .env.sample .env +# Edit .env and add your configuration +``` ---- +4. Run development server +```bash +npm run dev +``` -## Installation and Setup +5. Open [http://localhost:3000](http://localhost:3000) in your browser -### Prerequisites +## Environment Configuration πŸ”§ -- **Node.js** (v14+) -- **Python** (3.8+) -- **Docker** -- **MetaMask/Argent Wallet** +Create a `.env` file with the following keys: +- `NEXT_PUBLIC_FIREBASE_CONFIG` +- `NEXT_PUBLIC_PARTICLE_APP_ID` +- `NEXT_PUBLIC_PARTICLE_PROJECT_ID` +- `NEXT_PUBLIC_IEXEC_APP_ID` +- `ETHEREUM_PRIVATE_KEY` -### Local Development +## Deployment 🌐 -1. Clone the repository: +### Vercel Deployment +```bash +npm run build +vercel deploy +``` - ```bash - git clone https://github.com/yourusername/trading-platform.git - cd trading-platform - ``` +### Docker Deployment +```bash +docker build -t pulsetrade . +docker run -p 3000:3000 pulsetrade +``` -2. Install dependencies: +## Project Structure πŸ“‚ - ```bash - npm install - cd ai-engine && pip install -r requirements.txt - ``` +``` +/src +β”œβ”€β”€ app/ # Next.js pages and routes +β”œβ”€β”€ components/ # Reusable UI components +β”œβ”€β”€ lib/ # Utility functions and services +β”‚ β”œβ”€β”€ hooks/ # Custom React hooks +β”‚ └── services/ # API and blockchain interactions +β”œβ”€β”€ styles/ # Global styles +└── types/ # TypeScript type definitions +``` -3. Start the services: +## Feature Highlights ✨ - - **Frontend**: - ```bash - npm run start - ``` - - **Backend**: - ```bash - npm run server - ``` - - **AI Engine**: - ```bash - cd ai-engine && uvicorn main:app --reload - ``` +- πŸ€– AI-Powered Trading Recommendations +- πŸ’Ό Multi-Asset Trading Support +- πŸ”’ Secure Blockchain Transactions +- πŸ“Š Advanced Portfolio Analytics +- πŸŽ“ Learning & Reward Modules -4. Configure MT5 API and Blockchain network: +## Contributing 🀝 - - Update `.env` with API keys and smart contract addresses. +1. Fork the repository +2. Create a feature branch +3. Commit your changes +4. Push to the branch +5. Submit a Pull Request -5. Access the platform at `http://localhost:3000`. +Please read our [Contributing Guidelines](CONTRIBUTING.md) for more details. ---- +## License πŸ“„ -## Contributing +This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. -We welcome contributions! Please follow the standard GitHub workflow: +## Support πŸ’¬ -1. Fork the repository. -2. Create a new feature branch. -3. Submit a pull request with detailed notes on the changes. +For issues, questions, or discussions: +- Open a GitHub Issue +- Join our [Discord Community](#) +- Email: support@pulsetrade.com --- -## License - -This project is licensed under the MIT License. See the LICENSE file for details. +**Disclaimer**: Trading involves financial risk. Use PulseTrade responsibly and never invest more than you can afford to lose. \ No newline at end of file