diff --git a/README.md b/README.md index d20c5d4..58a6a5f 100644 --- a/README.md +++ b/README.md @@ -1,507 +1,55 @@ -# FlowState Pro by Uriesmooth +# FlowState Pro -[![MIT License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) -[![GitHub](https://img.shields.io/badge/GitHub-uriesmooth-black)](https://github.com/uriesmooth) -[![Node.js](https://img.shields.io/badge/Node.js-18%2B-green)](https://nodejs.org) -[![Code Style](https://img.shields.io/badge/code%20style-prettier-ff69b4)](https://prettier.io) +**Modular visual flow platform for teams that ship fast.** -**FlowState Pro** is a modular flow platform built for teams that ship fast. Build, connect, and deploy intelligent pipelines in minutes using a visual composer, with the flexibility to drop into custom code anytime. Scale easily, stay secure, and streamline your workflow seamlessly. +Build, connect, and deploy intelligent pipelines in minutes using a visual composer โ€” with full **NVIDIA GPU acceleration**, TensorRT optimization, and real-time vision capabilities. -๐ŸŒ **Live Demo:** [wooden-slick-flow-pro.base44.app](https://wooden-slick-flow-pro.base44.app) +๐ŸŒ **Website:** [uriesmooth.online](https://uriesmooth.online) +๐Ÿ“ฆ **Organization:** [UriesmoothTech](https://github.com/UriesmoothTech) --- -## Table of Contents +## Features -- [Features](#-features) -- [Quick Start](#-quick-start) -- [Documentation](#-documentation) -- [Project Structure](#๏ธ-project-structure) -- [Tech Stack](#๏ธ-tech-stack) -- [Usage Examples](#-usage-examples) -- [Testing](#-testing) -- [Contributing](#-contributing) -- [Support](#-support) -- [License](#-license) +- Visual flow composer +- Modular node-based pipelines +- Full **NVIDIA GPU** support (CUDA) +- **TensorRT** optimization for high-performance inference +- Real-time **Body โ€ข Reaction โ€ข Emotion Tracking** +- Easy local and containerized deployment --- -## โœจ Features +## GPU Acceleration -### Core Capabilities -- **Visual Composer** - Drag-and-drop pipeline builder with intuitive UI -- **Modular Architecture** - Reusable components for rapid development -- **Custom Code Integration** - Drop into custom JavaScript/Python anytime -- **Team Collaboration** - Real-time collaboration for distributed teams -- **Scalable Infrastructure** - Handle millions of pipeline executions +FlowState Pro is built to take full advantage of NVIDIA GPUs. -### Enterprise Features -- **Enterprise Security** - Built-in authentication, encryption, and compliance -- **Rich Integrations** - Connect with 100+ third-party services -- **API-First Design** - Powerful REST and GraphQL APIs -- **Advanced Analytics** - Monitor pipelines and execution metrics -- **Multi-tenant Support** - Isolate teams and organizations +- Native CUDA support +- Optimized for desktop and professional NVIDIA graphics cards +- TensorRT engine support for faster AI inference +- Ready for real-time computer vision workloads -### Developer Experience -- **No-Code & Low-Code** - Visual builder with custom code escape hatch -- **Pre-built Nodes** - 50+ ready-to-use components -- **Node Library** - Create and share custom nodes -- **Version Control** - Track changes and rollback easily -- **Local Development** - SDK for local testing and development +### Requirements +- NVIDIA GPU (RTX series recommended) +- Latest NVIDIA drivers +- NVIDIA Container Toolkit (for Docker) --- -## ๐Ÿš€ Quick Start +## Real-Time Vision -### Prerequisites -- **Node.js** 18.0.0 or higher -- **npm** 9.0.0 or higher -- **Git** for version control -- Optional: Docker for containerized deployment +FlowState Pro supports advanced vision capabilities: -### Installation +- **Body Movement Tracking** โ€” Pose and gesture recognition +- **Reaction Detection** โ€” Real-time response analysis +- **Emotion Recognition** โ€” Facial and affective state detection -#### 1. Clone the Repository -```bash -git clone https://github.com/uriesmooth/Uriesmooth-.git -cd Uriesmooth- -``` - -#### 2. Install Dependencies -```bash -npm install -``` - -#### 3. Configure Environment -```bash -# Copy the example environment file -cp .env.example .env - -# Edit .env with your configuration -# nano .env -``` - -#### 4. Start Development Server -```bash -npm run dev -``` - -#### 5. Access the Application -Open your browser and navigate to: -``` -http://localhost:3000 -``` - -### First Pipeline - -Once you're logged in: - -1. Click **"Create Pipeline"** -2. Add nodes by dragging from the sidebar -3. Connect nodes to create your flow -4. Click **"Deploy"** to activate -5. Monitor execution in the **Dashboard** - ---- - -## ๐Ÿ“š Documentation - -### Getting Started Guides -- [Installation Guide](docs/installation.md) - Detailed setup instructions -- [Quick Start Tutorial](docs/quickstart.md) - Build your first pipeline in 5 minutes -- [Configuration Guide](docs/configuration.md) - Environment setup and customization - -### Core Concepts -- [Pipelines](docs/concepts/pipelines.md) - Understand pipeline structure -- [Flows & Nodes](docs/concepts/flows.md) - Core building blocks -- [Triggers](docs/concepts/triggers.md) - How to trigger pipelines -- [Actions](docs/concepts/actions.md) - Execute tasks and integrations - -### API Reference -- [REST API](docs/api/rest.md) - RESTful API documentation -- [GraphQL API](docs/api/graphql.md) - GraphQL schema and queries -- [Webhooks](docs/api/webhooks.md) - Incoming and outgoing webhooks -- [SDK Reference](docs/api/sdk.md) - JavaScript/TypeScript SDK - -### Advanced Topics -- [Custom Nodes](docs/advanced/custom-nodes.md) - Build your own nodes -- [Deployment Strategies](docs/advanced/deployment.md) - Production deployment -- [Performance Optimization](docs/advanced/performance.md) - Scaling pipelines -- [Security Best Practices](docs/advanced/security.md) - Security hardening - -### Examples -- [Data Processing](examples/data-processing.md) - ETL pipelines -- [Webhook Integration](examples/webhooks.md) - Real-time integrations -- [Scheduled Tasks](examples/scheduled-tasks.md) - Cron-style scheduling -- [Error Handling](examples/error-handling.md) - Robust error management +These features are accelerated with NVIDIA GPU + TensorRT. --- -## ๐Ÿ—๏ธ Project Structure - -``` -Uriesmooth-/ -โ”œโ”€โ”€ src/ # Source code -โ”‚ โ”œโ”€โ”€ components/ # Reusable UI components -โ”‚ โ”‚ โ”œโ”€โ”€ pipeline/ -โ”‚ โ”‚ โ”œโ”€โ”€ nodes/ -โ”‚ โ”‚ โ”œโ”€โ”€ canvas/ -โ”‚ โ”‚ โ””โ”€โ”€ shared/ -โ”‚ โ”œโ”€โ”€ pages/ # Application pages -โ”‚ โ”‚ โ”œโ”€โ”€ dashboard/ -โ”‚ โ”‚ โ”œโ”€โ”€ pipelines/ -โ”‚ โ”‚ โ”œโ”€โ”€ settings/ -โ”‚ โ”‚ โ””โ”€โ”€ auth/ -โ”‚ โ”œโ”€โ”€ api/ # API routes & handlers -โ”‚ โ”‚ โ”œโ”€โ”€ auth/ -โ”‚ โ”‚ โ”œโ”€โ”€ pipelines/ -โ”‚ โ”‚ โ”œโ”€โ”€ executions/ -โ”‚ โ”‚ โ””โ”€โ”€ integrations/ -โ”‚ โ”œโ”€โ”€ services/ # Business logic -โ”‚ โ”‚ โ”œโ”€โ”€ pipeline.service.js -โ”‚ โ”‚ โ”œโ”€โ”€ execution.service.js -โ”‚ โ”‚ โ””โ”€โ”€ integration.service.js -โ”‚ โ”œโ”€โ”€ utils/ # Utility functions -โ”‚ โ”‚ โ”œโ”€โ”€ validators/ -โ”‚ โ”‚ โ”œโ”€โ”€ formatters/ -โ”‚ โ”‚ โ””โ”€โ”€ helpers/ -โ”‚ โ”œโ”€โ”€ styles/ # Global styles -โ”‚ โ”‚ โ”œโ”€โ”€ variables.scss -โ”‚ โ”‚ โ”œโ”€โ”€ globals.scss -โ”‚ โ”‚ โ””โ”€โ”€ themes/ -โ”‚ โ”œโ”€โ”€ config/ # Configuration -โ”‚ โ”‚ โ”œโ”€โ”€ database.js -โ”‚ โ”‚ โ”œโ”€โ”€ redis.js -โ”‚ โ”‚ โ””โ”€โ”€ logger.js -โ”‚ โ””โ”€โ”€ middleware/ # Express middleware -โ”‚ โ”œโ”€โ”€ auth.js -โ”‚ โ”œโ”€โ”€ errorHandler.js -โ”‚ โ””โ”€โ”€ requestLogger.js -โ”‚ -โ”œโ”€โ”€ public/ # Static assets -โ”‚ โ”œโ”€โ”€ images/ -โ”‚ โ”œโ”€โ”€ icons/ -โ”‚ โ””โ”€โ”€ fonts/ -โ”‚ -โ”œโ”€โ”€ docs/ # Documentation -โ”‚ โ”œโ”€โ”€ concepts/ -โ”‚ โ”œโ”€โ”€ api/ -โ”‚ โ”œโ”€โ”€ advanced/ -โ”‚ โ””โ”€โ”€ examples/ -โ”‚ -โ”œโ”€โ”€ tests/ # Test suites -โ”‚ โ”œโ”€โ”€ unit/ -โ”‚ โ”œโ”€โ”€ integration/ -โ”‚ โ””โ”€โ”€ e2e/ -โ”‚ -โ”œโ”€โ”€ .github/ # GitHub configuration -โ”‚ โ”œโ”€โ”€ workflows/ # CI/CD pipelines -โ”‚ โ”œโ”€โ”€ ISSUE_TEMPLATE/ -โ”‚ โ””โ”€โ”€ PULL_REQUEST_TEMPLATE/ -โ”‚ -โ”œโ”€โ”€ config/ # Configuration files -โ”‚ โ”œโ”€โ”€ webpack.config.js -โ”‚ โ”œโ”€โ”€ jest.config.js -โ”‚ โ””โ”€โ”€ eslint.config.js -โ”‚ -โ”œโ”€โ”€ docker/ # Docker files -โ”‚ โ”œโ”€โ”€ Dockerfile -โ”‚ โ”œโ”€โ”€ docker-compose.yml -โ”‚ โ””โ”€โ”€ .dockerignore -โ”‚ -โ”œโ”€โ”€ k8s/ # Kubernetes manifests -โ”‚ โ”œโ”€โ”€ deployment.yaml -โ”‚ โ”œโ”€โ”€ service.yaml -โ”‚ โ””โ”€โ”€ configmap.yaml -โ”‚ -โ”œโ”€โ”€ .env.example # Environment template -โ”œโ”€โ”€ .gitignore # Git ignore rules -โ”œโ”€โ”€ .dockerignore # Docker ignore rules -โ”œโ”€โ”€ package.json # Dependencies & scripts -โ”œโ”€โ”€ package-lock.json # Locked versions -โ”œโ”€โ”€ Dockerfile # Container image -โ”œโ”€โ”€ docker-compose.yml # Local development compose -โ”œโ”€โ”€ LICENSE # MIT License -โ”œโ”€โ”€ CONTRIBUTING.md # Contribution guidelines -โ”œโ”€โ”€ SECURITY.md # Security policy -โ””โ”€โ”€ README.md # This file -``` - ---- - -## ๐Ÿ› ๏ธ Tech Stack - -### Frontend -| Technology | Purpose | -|-----------|---------| -| **React 18** | UI Framework | -| **Redux Toolkit** | State Management | -| **Tailwind CSS** | Styling | -| **React Query** | Data Fetching | -| **React Flow** | Node-based Editor | -| **TypeScript** | Type Safety | - -### Backend -| Technology | Purpose | -|-----------|---------| -| **Node.js** | Runtime | -| **Express.js** | Web Framework | -| **PostgreSQL** | Primary Database | -| **Redis** | Caching & Queue | -| **Socket.io** | Real-time Communication | -| **JWT** | Authentication | - -### DevOps & Tools -| Technology | Purpose | -|-----------|---------| -| **Docker** | Containerization | -| **Kubernetes** | Orchestration | -| **GitHub Actions** | CI/CD | -| **Jest** | Testing | -| **ESLint** | Linting | -| **Prettier** | Code Formatting | - ---- - -## ๐Ÿ“– Usage Examples - -### Example 1: Create a Data Processing Pipeline - -```javascript -import { FlowState } from '@flowstate/sdk'; - -const flowstate = new FlowState({ - apiKey: 'your-api-key', - baseUrl: 'https://api.flowstate.io' -}); - -// Create a pipeline -const pipeline = await flowstate.pipelines.create({ - name: 'Daily Data Sync', - description: 'Sync data from API to database', - - nodes: [ - { - id: 'webhook-trigger', - type: 'trigger', - config: { - event: 'webhook', - path: '/data-sync' - } - }, - { - id: 'fetch-data', - type: 'http', - config: { - method: 'GET', - url: 'https://api.example.com/data', - headers: { 'Authorization': 'Bearer token' } - } - }, - { - id: 'transform', - type: 'transform', - config: { - script: ` - return data.map(item => ({ - id: item.id, - name: item.title, - updated_at: new Date() - })); - ` - } - }, - { - id: 'save-to-db', - type: 'database', - config: { - provider: 'postgresql', - table: 'data_sync', - action: 'upsert' - } - } - ], - - connections: [ - { from: 'webhook-trigger', to: 'fetch-data' }, - { from: 'fetch-data', to: 'transform' }, - { from: 'transform', to: 'save-to-db' } - ] -}); - -console.log('Pipeline created:', pipeline.id); -``` - -### Example 2: Deploy to Docker +## Quick Start ```bash -# Build the Docker image -docker build -t flowstate-pro:v1.0.0 . - -# Run the container -docker run -p 3000:3000 \ - -e NODE_ENV=production \ - -e DATABASE_URL=postgresql://user:pass@host:5432/db \ - -e JWT_SECRET=your-secret-key \ - flowstate-pro:v1.0.0 - -# Push to Docker Hub -docker login -docker tag flowstate-pro:v1.0.0 yourusername/flowstate-pro:v1.0.0 -docker push yourusername/flowstate-pro:v1.0.0 -``` - -### Example 3: Deploy to Kubernetes - -```bash -# Create namespace -kubectl create namespace flowstate - -# Deploy application -kubectl apply -f k8s/deployment.yaml -n flowstate -kubectl apply -f k8s/service.yaml -n flowstate - -# Check status -kubectl get pods -n flowstate -kubectl logs -f deployment/flowstate-pro -n flowstate -``` - ---- - -## ๐Ÿงช Testing - -### Run Tests -```bash -# Run all tests with coverage -npm test - -# Run tests in watch mode -npm run test:watch - -# Run specific test file -npm test -- tests/api.test.js - -# Run only unit tests -npm test -- --testPathPattern=unit - -# Generate coverage report -npm run test:coverage -``` - -### Test Structure -``` -tests/ -โ”œโ”€โ”€ unit/ # Component and function tests -โ”œโ”€โ”€ integration/ # API and service tests -โ””โ”€โ”€ e2e/ # End-to-end tests -``` - ---- - -## ๐Ÿค Contributing - -We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for details on: - -- Code style guidelines -- Testing requirements -- Pull request process -- Commit message conventions -- Development setup - -### Quick Start for Contributors - -```bash -# 1. Fork the repository -git clone https://github.com/yourusername/Uriesmooth-.git -cd Uriesmooth- - -# 2. Create a feature branch -git checkout -b feature/amazing-feature - -# 3. Make changes and commit -git add . -git commit -m "feat: Add amazing feature" - -# 4. Push and create PR -git push origin feature/amazing-feature -``` - ---- - -## ๐Ÿ› Bug Reports & Feature Requests - -- **๐Ÿ› Found a bug?** [Create an Issue](https://github.com/uriesmooth/Uriesmooth-/issues/new?labels=bug) -- **โœจ Have an idea?** [Request a Feature](https://github.com/uriesmooth/Uriesmooth-/discussions/new) - ---- - -## ๐Ÿ“‹ Roadmap - -### Q3 2024 -- [ ] Advanced analytics dashboard -- [ ] ML-powered optimization suggestions -- [ ] Custom node marketplace - -### Q4 2024 -- [ ] Mobile app for iOS/Android -- [ ] Enterprise SSO integration -- [ ] Advanced audit logging - -### 2025 -- [ ] Real-time collaboration v2 -- [ ] AI assistant for pipeline building -- [ ] Advanced workflow templates - -[View Full Roadmap โ†’](https://github.com/uriesmooth/Uriesmooth-/projects) - ---- - -## ๐Ÿ“ž Support - -- **๐Ÿ“– Documentation:** [docs/](docs/) -- **๐Ÿ’ฌ Community Chat:** [GitHub Discussions](https://github.com/uriesmooth/Uriesmooth-/discussions) -- **๐Ÿ› Issues:** [GitHub Issues](https://github.com/uriesmooth/Uriesmooth-/issues) -- **๐Ÿ“ง Email:** support@flowstatepro.io -- **๐Ÿฆ Twitter:** [@flowstatepro](https://twitter.com/flowstatepro) - ---- - -## ๐Ÿ“„ License - -This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. - ---- - -## ๐Ÿ™ Acknowledgments - -- Built with โค๏ธ for teams that ship fast -- Inspired by modern workflow automation platforms -- Thanks to all [contributors](https://github.com/uriesmooth/Uriesmooth-/graphs/contributors) -- Special thanks to the open-source community - ---- - -## ๐Ÿ“Š Project Stats - -![GitHub Stars](https://img.shields.io/github/stars/uriesmooth/Uriesmooth-?style=social) -![GitHub Forks](https://img.shields.io/github/forks/uriesmooth/Uriesmooth-?style=social) -![GitHub Watchers](https://img.shields.io/github/watchers/uriesmooth/Uriesmooth-?style=social) -![GitHub License](https://img.shields.io/github/license/uriesmooth/Uriesmooth-) - ---- - -## Security & Privacy - -- ๐Ÿ”’ [Security Policy](SECURITY.md) - Responsible disclosure -- ๐Ÿ“‹ [Privacy Policy](docs/privacy.md) - Data handling -- ๐Ÿ›ก๏ธ [Compliance](docs/compliance.md) - GDPR, SOC 2, ISO 27001 - ---- - -
- -**Made with ๐Ÿš€ by [Uriesmooth](https://github.com/uriesmooth)** - -[โฌ† Back to top](#flowstate-pro-by-uriesmooth) - -
\ No newline at end of file +git clone https://github.com/UriesmoothTech/flowstate-pro.git +cd flowstate-pro \ No newline at end of file