Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
211 changes: 25 additions & 186 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,207 +1,46 @@
# AI Chat Bot with Blockchain Integration
Below is a concise, useful version of your README:

A sophisticated AI chat interface built with Next.js, featuring blockchain wallet integration, real-time content generation, and image handling capabilities. This project combines the power of AI with blockchain technology to provide a secure, intelligent chat experience.

## 🚨 AI Disclaimer
Chainable Guru: Crypto Pricefeed with AI Intelligence

This project uses AI models and may generate content. Please note:
A sleek dashboard providing real-time crypto price feeds combined with AI-powered insights and blockchain wallet integration.

- Content is AI-generated and may not always be accurate
- The AI has access to read-only wallet data but cannot perform transactions
- Responses are generated in real-time and may vary
- Not financial advice - verify all blockchain-related information
- Models may have biases or limitations
- AI responses are streamed for real-time interaction
Key Features
1. Real-Time Price Feed & AI Insights
• Displays live crypto prices with smart dashboard analytics.
2. Blockchain Wallet Integration
• Secure, read-only access to wallet data and transaction history.
3. Modern Tech Stack
• Built with Next.js, TypeScript, and Supabase for reliability and scalability.

## 🌟 Features
Getting Started
1. Clone and Install

### AI Chat Interface

- Real-time streaming responses with progress indicators
- Context-aware conversations with memory
- Document creation and editing in blocks interface
- Code generation and explanation with syntax highlighting
- Multi-modal content generation (text, code, images)
- Smart suggestions and auto-completions

### Blockchain Integration

- Read-only wallet data access for security
- Real-time balance checking across multiple chains
- Detailed transaction history viewing
- NFT collection browsing and metadata display
- Gas estimation and network status
- Support for multiple wallet providers

### Image Handling

- Intelligent avatar support with automatic sizing
- Robust fallback image system
- Optimized loading with lazy load
- Multiple source support (Vercel, GitHub, custom domains)
- Automatic image optimization
- Responsive image handling

### Developer Experience

- TypeScript for type safety
- Comprehensive test coverage with Vitest
- Real-time development with Fast Refresh
- Modular component architecture
- Custom hooks for reusability
- Detailed documentation and examples

## 🛠 Tech Stack

### Frontend

- Next.js 14 (App Router)
- TypeScript
- Tailwind CSS
- Geist UI
- shadcn/ui components

### Backend

- Supabase
- Edge Functions
- Serverless Functions
- Real-time subscriptions

### AI & Blockchain

- Vercel AI SDK
- Multiple AI model support
- Blockchain API integration
- Wallet connection handlers

### Testing & Quality

- Vitest
- React Testing Library
- TypeScript strict mode
- ESLint & Prettier

## 📦 Installation

1. Clone the repository:

```bash
git clone https://github.com/yourusername/ai-chatbot.git
cd ai-chatbot
```

2. Install dependencies:

```bash
git clone https://github.com/yourusername/chainable-guru.git
cd chainable-guru
pnpm install
```

3. Set up environment variables:

```bash
cp .env.example .env.local
```

4. Configure your environment variables in `.env.local`:
2. Configure Environment
• Copy .env.example to .env.local and set your API keys.
3. Run the App

```bash
# OpenAI Configuration
OPENAI_API_KEY=your_openai_api_key_here

# Supabase Configuration
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url_here
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key_here

# WalletConnect
NEXT_PUBLIC_WALLET_CONNECT_PROJECT_ID=your_project_id_here

# Base Network Configuration
NEXT_PUBLIC_BASE_MAINNET_RPC=https://mainnet.base.org
NEXT_PUBLIC_BASE_SEPOLIA_RPC=https://sepolia.base.org
```

5. Start the development server:

```bash
pnpm dev
```

## 🧪 Testing

Run the test suite:

```bash
# Run tests
pnpm test

# Run tests with coverage
pnpm test:coverage

# Run tests in watch mode
pnpm test:watch
```

## 📚 Documentation

- [Component Documentation](./docs/COMPONENTS.md)
- [API Documentation](./docs/API.md)
- [Testing Guide](./docs/TESTING.md)
- [Contributing Guide](./CONTRIBUTING.md)

## 🔒 Security
Testing
• Run tests:

- All wallet interactions are read-only
- No private keys are stored or transmitted
- Data is encrypted at rest
- Regular security audits
- Comprehensive error handling

## 🤝 Contributing

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 🙏 Acknowledgments

- [Vercel](https://vercel.com) for hosting and deployment
- [Supabase](https://supabase.com) for database and authentication
- [OpenAI](https://openai.com) for AI capabilities
- [shadcn/ui](https://ui.shadcn.com) for UI components
- [Rainbow Kit](https://www.rainbowkit.com/) for wallet integration

## 🔄 Updates & Roadmap

### Latest Updates

- Added multi-modal content support
- Improved real-time streaming performance
- Enhanced wallet integration features
- Added comprehensive test coverage
- Implemented new UI components
pnpm test

### Upcoming Features

- [ ] Enhanced NFT support
- [ ] Additional AI model integrations
- [ ] Improved code generation
- [ ] Advanced document editing
- [ ] Extended blockchain support

## 💬 Support
License

For support, please:
1. Check the [Documentation](./docs)
2. Search [Issues](https://github.com/yourusername/ai-chatbot/issues)
3. Open a new issue if needed
This project is licensed under the MIT License.

---

Built with ❤️ using Next.js, Supabase, and OpenAI
Want visuals or more details on any section?
Loading