{"id":32477151,"url":"https://github.com/wizardgeeky/agent-wizard","last_synced_at":"2026-05-13T23:31:42.143Z","repository":{"id":319446508,"uuid":"1078710147","full_name":"WizardGeeky/Agent-Wizard","owner":"WizardGeeky","description":"Agent Wizard monitors Web3 trades in real-time, analyzes market activity, and delivers instant notifications so you never miss the best time to trade.","archived":false,"fork":false,"pushed_at":"2025-10-23T09:36:55.000Z","size":246,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-26T22:58:09.974Z","etag":null,"topics":["adk-ts","aes-encryption","ai","ai-agents","authentication","authorization","coingecko-api","geminiai","iqai","jwt-authentication","nextjs","prompt","restful-api","shadcn-ui","telegrambot","trade-bot","typescript","web3"],"latest_commit_sha":null,"homepage":"https://agent-wizard.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/WizardGeeky.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-18T08:54:45.000Z","updated_at":"2025-10-23T09:36:59.000Z","dependencies_parsed_at":null,"dependency_job_id":"daaa7d2b-f05f-47b0-bf29-66d4116914f5","html_url":"https://github.com/WizardGeeky/Agent-Wizard","commit_stats":null,"previous_names":["wizardgeeky/agent-wizard"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/WizardGeeky/Agent-Wizard","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WizardGeeky%2FAgent-Wizard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WizardGeeky%2FAgent-Wizard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WizardGeeky%2FAgent-Wizard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WizardGeeky%2FAgent-Wizard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/WizardGeeky","download_url":"https://codeload.github.com/WizardGeeky/Agent-Wizard/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WizardGeeky%2FAgent-Wizard/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33004132,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-13T13:14:54.681Z","status":"ssl_error","status_checked_at":"2026-05-13T13:14:51.610Z","response_time":115,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adk-ts","aes-encryption","ai","ai-agents","authentication","authorization","coingecko-api","geminiai","iqai","jwt-authentication","nextjs","prompt","restful-api","shadcn-ui","telegrambot","trade-bot","typescript","web3"],"created_at":"2025-10-26T22:57:59.688Z","updated_at":"2026-05-13T23:31:42.138Z","avatar_url":"https://github.com/WizardGeeky.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\r\n# 🧙‍♂️ Agent Wizard\r\n\r\nAgent 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.\r\n\r\n## 🚀 Features\r\n- 📈 **Real-Time Trade Monitoring** - Live tracking of trades and market movements.\r\n- 🧠 **AI-Powered Risk Analysis** - Detects anomalies and volatility to mitigate risks.\r\n- 📬 **Telegram Notifications** - Instant alerts for trades and risk events.\r\n- 📊 **Advanced Analytics** - Interactive dashboards for deep insights.\r\n- 🤖 **Agent-Powered Workflows** - Automates monitoring and decision-making.\r\n- 👥 **Collaborative Insights** - Share insights and alerts with teams.\r\n\r\n## 🧪 Demo\r\nCheck out the live demo: [Agent Wizard](https://agent-wizard.vercel.app)\r\n\r\n## 📸 Proof Work\r\n\u003cimg width=\"1725\" height=\"801\" alt=\"Screenshot 2025-10-21 215658\" src=\"https://github.com/user-attachments/assets/c1ccd593-dfd7-4c22-8e25-389f80986d9a\" /\u003e  \u003cimg width=\"1326\" height=\"645\" alt=\"Screenshot 2025-10-18 180420\" src=\"https://github.com/user-attachments/assets/43cef318-9653-4051-9261-e7c1b87555f0\" /\u003e  \u003cimg width=\"1905\" height=\"911\" alt=\"Screenshot 2025-10-21 215812\" src=\"https://github.com/user-attachments/assets/486cee43-28e2-4e71-8b08-6538292228ad\" /\u003e  \u003cimg width=\"1905\" height=\"890\" alt=\"Screenshot 2025-10-21 215832\" src=\"https://github.com/user-attachments/assets/428d20c0-8cfe-4cc0-bde2-34efa37586f1\" /\u003e  \u003cimg width=\"1915\" height=\"891\" alt=\"Screenshot 2025-10-21 215846\" src=\"https://github.com/user-attachments/assets/a971d505-ba35-42b3-bcce-a4d7036ba860\" /\u003e\r\n\r\n### Mobile View\r\n\r\n\u003cimg width=\"371\" height=\"666\" alt=\"Screenshot 2025-10-21 220703\" src=\"https://github.com/user-attachments/assets/cb8a7bc3-07a9-422d-b7ba-3818d0b9f360\" /\u003e  \u003cimg width=\"371\" height=\"664\" alt=\"Screenshot 2025-10-21 220714\" src=\"https://github.com/user-attachments/assets/4bb03e57-9d24-4c89-83ce-895e04351b69\" /\u003e\r\n\r\n\r\n## 🌊 Application Flow\r\n\u003cimg width=\"2001\" height=\"1868\" alt=\"untitled (1)\" src=\"https://github.com/user-attachments/assets/cea42564-c812-4aa8-a70b-d073bbe31a29\" /\u003e\r\n\r\n## 🧩 Architecture Overview\r\n```\r\nFrontend (Next.js) ↔ Backend (Node.js API)\r\nBackend ↔ MongoDB (Data storage)\r\nBackend ↔ Ether.js (Web3 interactions)\r\nBackend ↔ AI Agents (Risk analysis)\r\nBackend ↔ Telegram/Email (Notifications)\r\n```\r\n\r\n## 🔐 Authentication\r\n- Web3 login via MetaMask\r\n- Traditional login via Magic.link\r\n- Secure session management with JWT Token\r\n- Data Encryption with AES\r\n\r\n## 🧠 AI Agents\r\n- **Trade Monitor Agent**: Monitoring Trade information of Web3 coins based on users Risk configuration\r\n- **Telegram Agent**: Sends real-time alerts\r\n- **Email Agent**: Sends risk summaries\r\n- **Chat Agent**: You can ask anything about web 3.0\r\n\r\n## 🧪 Testing\r\n```bash\r\nnpm run test\r\n```\r\nTools: Jest, Cypress\r\n\r\n## 🧰 Local Development\r\n```bash\r\ngit clone https://github.com/WizardGeeky/Agent-Wizard.git\r\ncd Agent-Wizard\r\nnpm install\r\nnpm run dev\r\n```\r\n\r\n## 🌐 Environment Variables\r\n```env\r\nMONGODB_URI = YOUR_MONGODB_URI\r\nCIPHER_SECRET = YOUR_OWN_CIPHER_KEY\r\nNEXT_PUBLIC_JWT_SECRET = YOUR_JWT_KEY\r\nNEXT_PUBLIC_PERSONAL_EMAIL = YOUR_EMAIL_ADDRESS\r\nNEXT_PUBLIC_BURNER_PASSWORD = YOUR_EMAIL_APP_PASSWORD\r\nTELEGRAM_BOT_TOKEN = YOUR_TELEGRAM_BOT_TOKEN\r\nGOOGLE_API_KEY = YOUR_GEMINIAI_KEY\r\nGOOGLE_SEARCH_KEY= YOUR_GOOGLE_SEARCH_APIKEY\r\nGOOGLE_CSE_ID = YOUR_GOOGLE_CSE_APIKEY\r\nNEXT_PUBLIC_APP_URL = YOUR_APPLICATION_URL\r\n```\r\n\r\n## 🧠 AI \u0026 ML Models\r\n- Uses ADK-TS and IQAI for anomaly detection and risk scoring\r\n- Real-time analysis of trade patterns\r\n\r\n## 📡 Web3 Integration\r\n- Ether.js for smart contract interaction\r\n- Wallet connection via MetaMask\r\n- Real-time blockchain event tracking\r\n\r\n## 🧾 API Reference\r\n\r\n\u003ctable width=\"100%\" border=\"0.5\" cellspacing=\"0\" cellpadding=\"6\"\u003e\r\n  \u003cthead\u003e\r\n    \u003ctr\u003e\r\n      \u003cth\u003e\u003cstrong\u003eAPI Path\u003c/strong\u003e\u003c/th\u003e\r\n      \u003cth\u003e\u003cstrong\u003eHTTP Method\u003c/strong\u003e\u003c/th\u003e\r\n      \u003cth\u003e\u003cstrong\u003eDescription\u003c/strong\u003e\u003c/th\u003e\r\n    \u003c/tr\u003e\r\n  \u003c/thead\u003e\r\n  \u003ctbody\u003e\r\n    \u003ctr\u003e\r\n      \u003ctd\u003e/api/v1/signup\u003c/td\u003e\r\n      \u003ctd\u003ePOST\u003c/td\u003e\r\n      \u003ctd\u003eUser Account creation with email and password\u003c/td\u003e\r\n    \u003c/tr\u003e\r\n    \u003ctr\u003e\r\n      \u003ctd\u003e/api/v1/chat\u003c/td\u003e\r\n      \u003ctd\u003ePOST\u003c/td\u003e\r\n      \u003ctd\u003eChat bot (ask anything about web3, trade market)\u003c/td\u003e\r\n    \u003c/tr\u003e\r\n    \u003ctr\u003e\r\n      \u003ctd\u003e/api/v1/login\u003c/td\u003e\r\n      \u003ctd\u003ePOST\u003c/td\u003e\r\n      \u003ctd\u003eAuthenticate user via email and password\u003c/td\u003e\r\n    \u003c/tr\u003e\r\n    \u003ctr\u003e\r\n      \u003ctd\u003e/api/v1/login/metamask\u003c/td\u003e\r\n      \u003ctd\u003ePOST\u003c/td\u003e\r\n      \u003ctd\u003eAuthenticate user via Metamask Wallect\u003c/td\u003e\r\n    \u003c/tr\u003e\r\n    \u003ctr\u003e\r\n      \u003ctd\u003e/api/v1/otp\u003c/td\u003e\r\n      \u003ctd\u003ePOST\u003c/td\u003e\r\n      \u003ctd\u003eSend Otp to User email\u003c/td\u003e\r\n    \u003c/tr\u003e\r\n    \u003ctr\u003e\r\n      \u003ctd\u003e/api/v1/password\u003c/td\u003e\r\n      \u003ctd\u003ePOST\u003c/td\u003e\r\n      \u003ctd\u003eSend Password Reset link to email\u003c/td\u003e\r\n    \u003c/tr\u003e\r\n    \u003ctr\u003e\r\n      \u003ctd\u003e/api/v1/password/reset\u003c/td\u003e\r\n      \u003ctd\u003ePOST\u003c/td\u003e\r\n      \u003ctd\u003eReset the password\u003c/td\u003e\r\n    \u003c/tr\u003e\r\n    \u003ctr\u003e\r\n      \u003ctd\u003e/api/v1/password\u003c/td\u003e\r\n      \u003ctd\u003ePOST\u003c/td\u003e\r\n      \u003ctd\u003eVerify Otp\u003c/td\u003e\r\n    \u003c/tr\u003e\r\n    \u003ctr\u003e\r\n      \u003ctd\u003e/api/v1/monitor\u003c/td\u003e\r\n      \u003ctd\u003ePOST\u003c/td\u003e\r\n      \u003ctd\u003eSelect web3 coins to wish list to monitor\u003c/td\u003e\r\n    \u003c/tr\u003e\r\n    \u003ctr\u003e\r\n      \u003ctd\u003e/api/v1/monitor\u003c/td\u003e\r\n      \u003ctd\u003eGET\u003c/td\u003e\r\n      \u003ctd\u003eGet all wish list coins\u003c/td\u003e\r\n    \u003c/tr\u003e\r\n    \u003ctr\u003e\r\n      \u003ctd\u003e/api/v1/analysis\u003c/td\u003e\r\n      \u003ctd\u003ePOST\u003c/td\u003e\r\n      \u003ctd\u003eGet All information or analytics about wish list coins\u003c/td\u003e\r\n    \u003c/tr\u003e\r\n    \u003ctr\u003e\r\n      \u003ctd\u003e/api/v1/risk\u003c/td\u003e\r\n      \u003ctd\u003ePOST\u003c/td\u003e\r\n      \u003ctd\u003eCreate Risk configuration for wish list coins on markey cap, volume in %\u003c/td\u003e\r\n    \u003c/tr\u003e\r\n    \u003ctr\u003e\r\n      \u003ctd\u003e/api/v1/risk\u003c/td\u003e\r\n      \u003ctd\u003eGET\u003c/td\u003e\r\n      \u003ctd\u003eGet All Risk Configuration\u003c/td\u003e\r\n    \u003c/tr\u003e\r\n    \u003ctr\u003e\r\n      \u003ctd\u003e/api/v1/risk\u003c/td\u003e\r\n      \u003ctd\u003eDELETE\u003c/td\u003e\r\n      \u003ctd\u003eDelete Risk Configuration\u003c/td\u003e\r\n    \u003c/tr\u003e\r\n  \u003c/tbody\u003e\r\n\u003c/table\u003e\r\n\r\n\r\n## 🧑‍💻 Contributing\r\n- Fork the repo\r\n- Create a feature branch\r\n- Submit a pull request\r\n\r\n## 🙋 FAQ\r\n**Q:** How do I connect my wallet?\r\n**A:** Use MetaMask extension and connect via the dashboard.\r\n\r\n**Q:** What chains are supported?\r\n**A:** Ethereum mainnet and testnets.\r\n\r\n**Q:** How is risk calculated?\r\n**A:** Using AI models that analyze trade volume, volatility, and historical patterns.\r\n\r\n## 📦 Tech Stack\r\n- **Frontend**: TypeScript, NextJS, ShadCN, MagicUI, Tailwind CSS\r\n- **Backend**: Node JS, NextJS, Nodemailer\r\n- **Database**: MongoDB\r\n- **Web3**: EtherJS\r\n- **Wallet**: MetaMask\r\n- **Notifications**: Telegram, Email\r\n- **AIML**: ADK-TS, IQAI\r\n- **AI Agents**: Telegram Agent, Email Agent, Chat Agent\r\n- **3rd Party APIs**: Coingecko, Alchemy\r\n\r\n## 📁 Folder Structure\r\n\r\n```\r\n├── 📁 app\r\n│   ├── 📁 adk\r\n│   │   ├── 📁 agent\r\n│   │   │   ├── 📄 agent.ts\r\n│   │   │   └── 📄 chatAgent.ts\r\n│   │   └── 📁 tools\r\n│   │       ├── 📄 RealGoogleSearch.ts\r\n│   │       └── 📄 telegramTool.ts\r\n│   ├── 📁 api\r\n│   │   └── 📁 v1\r\n│   │       ├── 📁 assets\r\n│   │       │   ├── 📁 analytics\r\n│   │       │   │   └── 📄 route.ts\r\n│   │       │   ├── 📁 monitor\r\n│   │       │   │   └── 📄 route.ts\r\n│   │       │   └── 📁 risk\r\n│   │       │       └── 📄 route.ts\r\n│   │       ├── 📁 chat\r\n│   │       │   └── 📄 route.ts\r\n│   │       ├── 📁 login\r\n│   │       │   ├── 📁 metamask\r\n│   │       │   │   └── 📄 route.ts\r\n│   │       │   └── 📄 route.ts\r\n│   │       ├── 📁 otp\r\n│   │       │   ├── 📁 verify\r\n│   │       │   │   └── 📄 route.ts\r\n│   │       │   └── 📄 route.ts\r\n│   │       ├── 📁 password\r\n│   │       │   ├── 📁 reset\r\n│   │       │   │   └── 📄 route.ts\r\n│   │       │   └── 📄 route.ts\r\n│   │       └── 📁 signup\r\n│   │           └── 📄 route.ts\r\n│   ├── 📁 components\r\n│   │   ├── 📄 Agent.tsx\r\n│   │   ├── 📄 Features.tsx\r\n│   │   ├── 📄 Hero.tsx\r\n│   │   ├── 📄 HowItWorks.tsx\r\n│   │   ├── 📄 LoginForm.tsx\r\n│   │   ├── 📄 Metamask.tsx\r\n│   │   ├── 📄 Nav.tsx\r\n│   │   └── 📄 SignUpForm.tsx\r\n│   ├── 📁 config\r\n│   │   ├── 📄 cipher.config.ts\r\n│   │   ├── 📄 database.config.ts\r\n│   │   ├── 📄 jwt.config.ts\r\n│   │   └── 📄 nodemailer.config.ts\r\n│   ├── 📁 contexts\r\n│   │   └── 📄 ThemeContext.tsx\r\n│   ├── 📁 dashboard\r\n│   │   ├── 📁 components\r\n│   │   │   ├── 📄 Analytics.tsx\r\n│   │   │   ├── 📄 CoinTable.tsx\r\n│   │   │   ├── 📄 dashboard.tsx\r\n│   │   │   ├── 📄 logout.tsx\r\n│   │   │   ├── 📄 profile.tsx\r\n│   │   │   └── 📄 riskanalysisengine.tsx\r\n│   │   └── 📄 page.tsx\r\n│   ├── 📁 lib\r\n│   │   └── 📄 cron.ts\r\n│   ├── 📁 models\r\n│   │   ├── 📄 AssetMonitor.ts\r\n│   │   ├── 📄 Otp.ts\r\n│   │   ├── 📄 RiskConfig.ts\r\n│   │   └── 📄 User.ts\r\n│   ├── 📁 password\r\n│   │   ├── 📁 reset\r\n│   │   │   └── 📄 page.tsx\r\n│   │   └── 📄 page.tsx\r\n│   ├── 📁 types\r\n│   │   ├── 📄 CoinEvent .ts\r\n│   │   └── 📄 CoinInfo.ts\r\n│   ├── 📁 utils\r\n│   │   └── 📁 templates\r\n│   │       ├── 📄 cryptoNotification.tsx\r\n│   │       ├── 📄 otpTemplate.tsx\r\n│   │       └── 📄 welcomeTemplate.tsx\r\n│   ├── 📄 favicon.ico\r\n│   ├── 🎨 globals.css\r\n│   ├── 📄 layout.tsx\r\n│   └── 📄 page.tsx\r\n├── 📁 components\r\n│   └── 📁 ui\r\n│       ├── 📄 animated-theme-toggler.tsx\r\n│       ├── 📄 aurora-text.tsx\r\n│       ├── 📄 button.tsx\r\n│       ├── 📄 card.tsx\r\n│       ├── 📄 chart.tsx\r\n│       ├── 📄 checkbox.tsx\r\n│       ├── 📄 dialog.tsx\r\n│       ├── 📄 floating-dock.tsx\r\n│       ├── 📄 input.tsx\r\n│       ├── 📄 label.tsx\r\n│       ├── 📄 loader.tsx\r\n│       ├── 📄 radio-group.tsx\r\n│       ├── 📄 ripple.tsx\r\n│       ├── 📄 select.tsx\r\n│       ├── 📄 switch.tsx\r\n│       ├── 📄 tabs.tsx\r\n│       ├── 📄 tooltip.tsx\r\n│       └── 📄 wobble-card.tsx\r\n├── 📁 lib\r\n│   └── 📄 utils.ts\r\n├── 📁 public\r\n├── ⚙️ .gitignore\r\n├── 📝 README.md\r\n├── ⚙️ components.json\r\n├── 📄 next.config.ts\r\n├── ⚙️ package-lock.json\r\n├── ⚙️ package.json\r\n├── 📄 postcss.config.mjs\r\n└── ⚙️ tsconfig.json\r\n```\r\n\r\n## 📄 License\r\nThis project is licensed under the MIT License.\r\n\r\n\r\n\r\n\r\n\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwizardgeeky%2Fagent-wizard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwizardgeeky%2Fagent-wizard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwizardgeeky%2Fagent-wizard/lists"}