{"id":30783334,"url":"https://github.com/piotrlaczkowski/webguibased-local-ideationagent","last_synced_at":"2025-09-05T10:50:34.886Z","repository":{"id":309738973,"uuid":"1037377197","full_name":"piotrlaczkowski/WebGUIBased-local-IdeationAgent","owner":"piotrlaczkowski","description":"Implementation of fully on-device AI Ideation agent.","archived":false,"fork":false,"pushed_at":"2025-08-13T14:15:31.000Z","size":101,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-13T15:44:20.740Z","etag":null,"topics":["agentic-ai","webgui"],"latest_commit_sha":null,"homepage":"https://piotrlaczkowski.github.io/WebGUIBased-local-IdeationAgent/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/piotrlaczkowski.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2025-08-13T13:34:45.000Z","updated_at":"2025-08-13T14:15:34.000Z","dependencies_parsed_at":"2025-08-13T15:44:33.221Z","dependency_job_id":"f117d776-dbb4-4cac-a135-c34bc8e281b6","html_url":"https://github.com/piotrlaczkowski/WebGUIBased-local-IdeationAgent","commit_stats":null,"previous_names":["piotrlaczkowski/webguibased-local-ideationagent"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/piotrlaczkowski/WebGUIBased-local-IdeationAgent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piotrlaczkowski%2FWebGUIBased-local-IdeationAgent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piotrlaczkowski%2FWebGUIBased-local-IdeationAgent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piotrlaczkowski%2FWebGUIBased-local-IdeationAgent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piotrlaczkowski%2FWebGUIBased-local-IdeationAgent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/piotrlaczkowski","download_url":"https://codeload.github.com/piotrlaczkowski/WebGUIBased-local-IdeationAgent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piotrlaczkowski%2FWebGUIBased-local-IdeationAgent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273747801,"owners_count":25160652,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-05T02:00:09.113Z","response_time":402,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["agentic-ai","webgui"],"created_at":"2025-09-05T10:50:33.443Z","updated_at":"2025-09-05T10:50:34.872Z","avatar_url":"https://github.com/piotrlaczkowski.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🧠 Idea Structuring Agent\n\n[![CI](https://github.com/piotrlaczkowski/WebGUIBased-local-IdeationAgent/actions/workflows/ci.yml/badge.svg)](https://github.com/piotrlaczkowski/WebGUIBased-local-IdeationAgent/actions/workflows/ci.yml)\n[![Deploy](https://github.com/piotrlaczkowski/WebGUIBased-local-IdeationAgent/actions/workflows/deploy.yml/badge.svg)](https://github.com/piotrlaczkowski/WebGUIBased-local-IdeationAgent/actions/workflows/deploy.yml)\n[![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=flat\u0026logo=typescript\u0026logoColor=white)](#)\n[![React](https://img.shields.io/badge/React-20232A?style=flat\u0026logo=react\u0026logoColor=61DAFB)](#)\n[![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-38B2AC?style=flat\u0026logo=tailwind-css\u0026logoColor=white)](#)\n[![Vite](https://img.shields.io/badge/Vite-646CFF?style=flat\u0026logo=vite\u0026logoColor=white)](#)\n\n\u003e **An intelligent AI-powered chatbot that helps users structure and develop their ideas through interactive conversations.**\n\nPowered by **LFM2 (LiquidFoundationModel-2)** running entirely in your browser using WebGPU, this application provides a sophisticated idea development experience with real-time conversation analysis, automatic summarization, and mobile-responsive design.\n\n## ✨ Features\n\n### 🤖 **AI-Powered Idea Development**\n- **Local AI Processing**: Runs entirely in-browser using WebGPU acceleration\n- **Intelligent Conversations**: LFM2 model provides contextual responses and follow-up questions\n- **Smart Context Management**: Automatically manages conversation context for longer sessions\n- **Real-time Summary Generation**: Live idea structuring and progress tracking\n\n### 📱 **Mobile-First Design**\n- **Fully Responsive**: Seamlessly adapts from mobile to desktop\n- **Touch-Optimized**: Large touch targets and smooth interactions\n- **Tab Navigation**: Easy switching between chat and summary on mobile\n- **Safe Area Support**: Works perfectly on devices with notches\n- **Performance Optimized**: Smooth animations and efficient rendering\n\n### 🎯 **Idea Structuring**\n- **Dynamic Summarization**: Real-time extraction of key concepts, goals, and next steps\n- **Progress Tracking**: Visual progress bars and completion metrics\n- **Smart Categorization**: Automatic organization of problems, solutions, and requirements\n- **Export Capabilities**: Generate comprehensive idea reports\n\n### 🛠️ **Developer Experience**\n- **Modern Tech Stack**: React 19, TypeScript, Tailwind CSS 4, Vite 7\n- **Type Safety**: Full TypeScript coverage with strict mode\n- **ESLint Integration**: Code quality enforcement\n- **Hot Reload**: Instant development feedback\n- **Optimized Builds**: Code splitting and performance optimization\n\n## 🚀 Live Demo\n\n**[Try it Live](https://piotrlaczkowski.github.io/WebGUIBased-local-IdeationAgent/)** \n\n*Note: WebGPU support required (Chrome/Edge 113+, Firefox Nightly)*\n\n## 🏗️ Technology Stack\n\n- **Frontend Framework**: React 19 with TypeScript\n- **Styling**: Tailwind CSS 4\n- **Build Tool**: Vite 7\n- **AI Model**: Hugging Face Transformers.js with LFM2\n- **Compute**: WebGPU for AI acceleration\n- **State Management**: React Hooks + IndexedDB for persistence\n- **Icons**: Lucide React\n- **Code Editor**: Monaco Editor (for system prompt editing)\n\n## 🛠️ Getting Started\n\n### Prerequisites\n\n- **Node.js** 18+ \n- **npm** or **yarn**\n- **Modern Browser** with WebGPU support:\n  - Chrome/Edge 113+\n  - Firefox Nightly (with WebGPU enabled)\n  - Safari Technology Preview (experimental)\n\n### Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/piotrlaczkowski/WebGUIBased-local-IdeationAgent.git\n   cd WebGUIBased-local-IdeationAgent\n   ```\n\n2. **Install dependencies**\n   ```bash\n   npm install\n   # or\n   yarn install\n   ```\n\n3. **Start development server**\n   ```bash\n   npm run dev\n   # or\n   yarn dev\n   ```\n\n4. **Open your browser**\n   Navigate to `http://localhost:3000`\n\n### First Time Setup\n\n1. **Model Loading**: On first visit, the LFM2 model (~350MB) will download automatically\n2. **WebGPU Check**: The app will verify WebGPU support and initialize the model\n3. **Start Chatting**: Begin describing your idea to start the structuring process\n\n## 🏃‍♂️ Development\n\n### Available Scripts\n\n| Script | Description |\n|--------|-------------|\n| `npm run dev` | Start development server |\n| `npm run build` | Build for production |\n| `npm run preview` | Preview production build |\n| `npm run lint` | Run ESLint |\n| `npm run lint:fix` | Fix ESLint errors |\n| `npm run type-check` | Run TypeScript type checking |\n| `npm run build:github` | Build for GitHub Pages |\n| `npm run serve` | Build and serve locally |\n\n### Development Workflow\n\n1. **Code Style**: ESLint and Prettier are configured for consistent formatting\n2. **Type Safety**: TypeScript strict mode ensures type safety\n3. **Hot Reload**: Changes reflect instantly in development\n4. **Module Federation**: Optimized chunk splitting for performance\n\n### Browser Compatibility\n\n| Browser | WebGPU Support | Status |\n|---------|----------------|---------|\n| Chrome 113+ | ✅ Native | Fully Supported |\n| Edge 113+ | ✅ Native | Fully Supported |\n| Firefox Nightly | ⚠️ Flag Required | Experimental |\n| Safari TP | ⚠️ Experimental | Limited Support |\n\n## 🚀 Deployment\n\n### Automatic Deployment (GitHub Pages)\n\nThis project includes automatic deployment to GitHub Pages via GitHub Actions.\n\n#### Setup Steps:\n\n1. **Enable GitHub Pages**\n   - Go to repository **Settings** → **Pages**\n   - Select **GitHub Actions** as source\n\n2. **Push to Main Branch**\n   ```bash\n   git push origin main\n   ```\n\n3. **Deployment Process**\n   - CI runs tests and builds the app\n   - Deployment workflow publishes to GitHub Pages\n   - Site available at `https://piotrlaczkowski.github.io/WebGUIBased-local-IdeationAgent/`\n\n#### Manual Deployment\n\n```bash\n# Build for GitHub Pages\nnpm run build:github\n\n# Deploy dist folder to your hosting provider\n```\n\n### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `VITE_BASE_PATH` | Base path for deployment | `/` |\n\n## 🔄 CI/CD Pipeline\n\n### Continuous Integration\n\n**Triggers**: Pull requests and pushes to `main`\n\n**Checks**:\n- ✅ ESLint code quality\n- ✅ TypeScript type checking  \n- ✅ Build verification\n- ✅ Dependency caching\n\n### Continuous Deployment\n\n**Triggers**: Pushes to `main` branch\n\n**Process**:\n1. Run full CI pipeline\n2. Build optimized production bundle\n3. Deploy to GitHub Pages\n4. Update live site\n\n### Build Optimization\n\n- **Code Splitting**: Vendor, UI, and ML libraries separated\n- **Tree Shaking**: Unused code eliminated\n- **Asset Optimization**: Images and fonts optimized\n- **Caching Strategy**: Long-term caching for static assets\n\n## 📱 Mobile Experience\n\n### Responsive Design\n- **Breakpoints**: Mobile-first approach with `lg:` prefix for desktop\n- **Touch Targets**: Minimum 44px for accessibility\n- **Safe Areas**: Support for notched devices\n- **Viewport Handling**: Proper mobile viewport configuration\n\n### Performance Optimizations\n- **Reduced Animations**: Simplified animations on mobile\n- **Touch Scrolling**: Native smooth scrolling\n- **GPU Acceleration**: Hardware acceleration where beneficial\n- **Memory Management**: Efficient resource usage\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](.github/CONTRIBUTING.md) for details.\n\n### Development Setup\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature/amazing-feature`\n3. Commit changes: `git commit -m 'Add amazing feature'`\n4. Push to branch: `git push origin feature/amazing-feature`\n5. Open a Pull Request\n\n### Code Standards\n\n- **TypeScript**: Strict mode, full type coverage\n- **ESLint**: Airbnb configuration with React hooks\n- **Prettier**: Automatic code formatting\n- **Conventional Commits**: Standard commit message format\n\n## 📋 Project Structure\n\n```\nLFM2-WebGPU-IDEATOR/\n├── .github/                 # GitHub Actions workflows\n│   ├── workflows/\n│   │   ├── ci.yml          # Continuous Integration\n│   │   └── deploy.yml      # Deployment workflow\n│   └── DEPLOYMENT.md       # Deployment documentation\n├── public/                 # Static assets\n│   ├── .nojekyll          # Disable Jekyll processing\n│   └── liquidai-logo.svg  # App icon\n├── src/\n│   ├── components/        # React components\n│   │   ├── icons/        # Icon components\n│   │   └── *.tsx         # UI components\n│   ├── constants/        # App configuration\n│   ├── hooks/           # Custom React hooks\n│   ├── utils.ts         # Utility functions\n│   ├── index.css        # Global styles\n│   └── main.tsx         # App entry point\n├── dist/                # Build output (generated)\n└── ...config files\n```\n\n## 🔧 Configuration\n\n### Vite Configuration\n- **Base Path**: Automatically configured for GitHub Pages\n- **Build Optimization**: Code splitting and source maps\n- **Development**: HMR and fast refresh\n\n### Tailwind CSS\n- **Version**: 4.x with modern features\n- **Mobile-First**: Responsive design approach\n- **Custom Classes**: Specialized mobile and animation classes\n\n## 🎯 Roadmap\n\n- [ ] **Offline Support**: PWA capabilities for offline usage\n- [ ] **Voice Input**: Speech-to-text for idea input\n- [ ] **Collaboration**: Real-time collaboration features\n- [ ] **Templates**: Pre-built idea structuring templates\n- [ ] **Export Formats**: PDF, Word, and other export options\n- [ ] **Analytics**: Idea development analytics dashboard\n\n## ❓ FAQ\n\n### WebGPU Issues\n**Q: Model fails to load?**\nA: Ensure you're using a supported browser with WebGPU enabled. Try Chrome 113+ for best compatibility.\n\n**Q: App runs slowly?**\nA: WebGPU acceleration requires a modern GPU. Integrated graphics may have reduced performance.\n\n### Development Issues\n**Q: Build fails?**\nA: Run `npm run type-check` to identify TypeScript issues, then `npm run lint:fix` for code quality.\n\n**Q: Hot reload not working?**\nA: Clear browser cache and restart development server: `npm run dev`\n\n## 📄 License\n\nThis project is licensed under the **Apache License 2.0** - see the [LICENSE](LICENSE) file for details.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Built with ❤️ using React, TypeScript, and WebGPU**\n\n[🌟 Star this repo](https://github.com/piotrlaczkowski/WebGUIBased-local-IdeationAgent) • [🐛 Report Bug](https://github.com/piotrlaczkowski/WebGUIBased-local-IdeationAgent/issues) • [💡 Request Feature](https://github.com/piotrlaczkowski/WebGUIBased-local-IdeationAgent/issues)\n\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiotrlaczkowski%2Fwebguibased-local-ideationagent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpiotrlaczkowski%2Fwebguibased-local-ideationagent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiotrlaczkowski%2Fwebguibased-local-ideationagent/lists"}