🧙‍♂️ Agent Wizard

Agent Wizard is a Web3-based real-time trade monitoring and risk management tool that leverages AI-powered analytics to track market activity, assess risks, and deliver instant alerts via Telegram, helping users make smarter trading decisions.

🚀 Features

• 📈 Real-Time Trade Monitoring - Live tracking of trades and market movements.
• 🧠 AI-Powered Risk Analysis - Detects anomalies and volatility to mitigate risks.
• 📬 Telegram Notifications - Instant alerts for trades and risk events.
• 📊 Advanced Analytics - Interactive dashboards for deep insights.
• 🤖 Agent-Powered Workflows - Automates monitoring and decision-making.
• 👥 Collaborative Insights - Share insights and alerts with teams.

🧪 Demo

Check out the live demo: Agent Wizard

📸 Proof Work

Mobile View

🌊 Application Flow

🧩 Architecture Overview

Frontend (Next.js) ↔ Backend (Node.js API)
Backend ↔ MongoDB (Data storage)
Backend ↔ Ether.js (Web3 interactions)
Backend ↔ AI Agents (Risk analysis)
Backend ↔ Telegram/Email (Notifications)

🔐 Authentication

• Web3 login via MetaMask
• Traditional login via Magic.link
• Secure session management with JWT Token
• Data Encryption with AES

🧠 AI Agents

• Trade Monitor Agent: Monitoring Trade information of Web3 coins based on users Risk configuration
• Telegram Agent: Sends real-time alerts
• Email Agent: Sends risk summaries
• Chat Agent: You can ask anything about web 3.0

🧪 Testing

npm run test

Tools: Jest, Cypress

🧰 Local Development

git clone https://github.com/WizardGeeky/Agent-Wizard.git
cd Agent-Wizard
npm install
npm run dev

🌐 Environment Variables

MONGODB_URI = YOUR_MONGODB_URI
CIPHER_SECRET = YOUR_OWN_CIPHER_KEY
NEXT_PUBLIC_JWT_SECRET = YOUR_JWT_KEY
NEXT_PUBLIC_PERSONAL_EMAIL = YOUR_EMAIL_ADDRESS
NEXT_PUBLIC_BURNER_PASSWORD = YOUR_EMAIL_APP_PASSWORD
TELEGRAM_BOT_TOKEN = YOUR_TELEGRAM_BOT_TOKEN
GOOGLE_API_KEY = YOUR_GEMINIAI_KEY
GOOGLE_SEARCH_KEY= YOUR_GOOGLE_SEARCH_APIKEY
GOOGLE_CSE_ID = YOUR_GOOGLE_CSE_APIKEY
NEXT_PUBLIC_APP_URL = YOUR_APPLICATION_URL

🧠 AI & ML Models

• Uses ADK-TS and IQAI for anomaly detection and risk scoring
• Real-time analysis of trade patterns

📡 Web3 Integration

• Ether.js for smart contract interaction
• Wallet connection via MetaMask
• Real-time blockchain event tracking

🧾 API Reference

API Path	HTTP Method	Description
/api/v1/signup	POST	User Account creation with email and password
/api/v1/chat	POST	Chat bot (ask anything about web3, trade market)
/api/v1/login	POST	Authenticate user via email and password
/api/v1/login/metamask	POST	Authenticate user via Metamask Wallect
/api/v1/otp	POST	Send Otp to User email
/api/v1/password	POST	Send Password Reset link to email
/api/v1/password/reset	POST	Reset the password
/api/v1/password	POST	Verify Otp
/api/v1/monitor	POST	Select web3 coins to wish list to monitor
/api/v1/monitor	GET	Get all wish list coins
/api/v1/analysis	POST	Get All information or analytics about wish list coins
/api/v1/risk	POST	Create Risk configuration for wish list coins on markey cap, volume in %
/api/v1/risk	GET	Get All Risk Configuration
/api/v1/risk	DELETE	Delete Risk Configuration

🧑‍💻 Contributing

• Fork the repo
• Create a feature branch
• Submit a pull request

🙋 FAQ

Q: How do I connect my wallet? A: Use MetaMask extension and connect via the dashboard.

Q: What chains are supported? A: Ethereum mainnet and testnets.

Q: How is risk calculated? A: Using AI models that analyze trade volume, volatility, and historical patterns.

📦 Tech Stack

• Frontend: TypeScript, NextJS, ShadCN, MagicUI, Tailwind CSS
• Backend: Node JS, NextJS, Nodemailer
• Database: MongoDB
• Web3: EtherJS
• Wallet: MetaMask
• Notifications: Telegram, Email
• AIML: ADK-TS, IQAI
• AI Agents: Telegram Agent, Email Agent, Chat Agent
• 3rd Party APIs: Coingecko, Alchemy

📁 Folder Structure

├── 📁 app
│   ├── 📁 adk
│   │   ├── 📁 agent
│   │   │   ├── 📄 agent.ts
│   │   │   └── 📄 chatAgent.ts
│   │   └── 📁 tools
│   │       ├── 📄 RealGoogleSearch.ts
│   │       └── 📄 telegramTool.ts
│   ├── 📁 api
│   │   └── 📁 v1
│   │       ├── 📁 assets
│   │       │   ├── 📁 analytics
│   │       │   │   └── 📄 route.ts
│   │       │   ├── 📁 monitor
│   │       │   │   └── 📄 route.ts
│   │       │   └── 📁 risk
│   │       │       └── 📄 route.ts
│   │       ├── 📁 chat
│   │       │   └── 📄 route.ts
│   │       ├── 📁 login
│   │       │   ├── 📁 metamask
│   │       │   │   └── 📄 route.ts
│   │       │   └── 📄 route.ts
│   │       ├── 📁 otp
│   │       │   ├── 📁 verify
│   │       │   │   └── 📄 route.ts
│   │       │   └── 📄 route.ts
│   │       ├── 📁 password
│   │       │   ├── 📁 reset
│   │       │   │   └── 📄 route.ts
│   │       │   └── 📄 route.ts
│   │       └── 📁 signup
│   │           └── 📄 route.ts
│   ├── 📁 components
│   │   ├── 📄 Agent.tsx
│   │   ├── 📄 Features.tsx
│   │   ├── 📄 Hero.tsx
│   │   ├── 📄 HowItWorks.tsx
│   │   ├── 📄 LoginForm.tsx
│   │   ├── 📄 Metamask.tsx
│   │   ├── 📄 Nav.tsx
│   │   └── 📄 SignUpForm.tsx
│   ├── 📁 config
│   │   ├── 📄 cipher.config.ts
│   │   ├── 📄 database.config.ts
│   │   ├── 📄 jwt.config.ts
│   │   └── 📄 nodemailer.config.ts
│   ├── 📁 contexts
│   │   └── 📄 ThemeContext.tsx
│   ├── 📁 dashboard
│   │   ├── 📁 components
│   │   │   ├── 📄 Analytics.tsx
│   │   │   ├── 📄 CoinTable.tsx
│   │   │   ├── 📄 dashboard.tsx
│   │   │   ├── 📄 logout.tsx
│   │   │   ├── 📄 profile.tsx
│   │   │   └── 📄 riskanalysisengine.tsx
│   │   └── 📄 page.tsx
│   ├── 📁 lib
│   │   └── 📄 cron.ts
│   ├── 📁 models
│   │   ├── 📄 AssetMonitor.ts
│   │   ├── 📄 Otp.ts
│   │   ├── 📄 RiskConfig.ts
│   │   └── 📄 User.ts
│   ├── 📁 password
│   │   ├── 📁 reset
│   │   │   └── 📄 page.tsx
│   │   └── 📄 page.tsx
│   ├── 📁 types
│   │   ├── 📄 CoinEvent .ts
│   │   └── 📄 CoinInfo.ts
│   ├── 📁 utils
│   │   └── 📁 templates
│   │       ├── 📄 cryptoNotification.tsx
│   │       ├── 📄 otpTemplate.tsx
│   │       └── 📄 welcomeTemplate.tsx
│   ├── 📄 favicon.ico
│   ├── 🎨 globals.css
│   ├── 📄 layout.tsx
│   └── 📄 page.tsx
├── 📁 components
│   └── 📁 ui
│       ├── 📄 animated-theme-toggler.tsx
│       ├── 📄 aurora-text.tsx
│       ├── 📄 button.tsx
│       ├── 📄 card.tsx
│       ├── 📄 chart.tsx
│       ├── 📄 checkbox.tsx
│       ├── 📄 dialog.tsx
│       ├── 📄 floating-dock.tsx
│       ├── 📄 input.tsx
│       ├── 📄 label.tsx
│       ├── 📄 loader.tsx
│       ├── 📄 radio-group.tsx
│       ├── 📄 ripple.tsx
│       ├── 📄 select.tsx
│       ├── 📄 switch.tsx
│       ├── 📄 tabs.tsx
│       ├── 📄 tooltip.tsx
│       └── 📄 wobble-card.tsx
├── 📁 lib
│   └── 📄 utils.ts
├── 📁 public
├── ⚙️ .gitignore
├── 📝 README.md
├── ⚙️ components.json
├── 📄 next.config.ts
├── ⚙️ package-lock.json
├── ⚙️ package.json
├── 📄 postcss.config.mjs
└── ⚙️ tsconfig.json

📄 License

This project is licensed under the MIT License.