{"id":43048344,"url":"https://github.com/hummbl-dev/hummbl","last_synced_at":"2026-01-31T10:09:15.394Z","repository":{"id":323181741,"uuid":"1079970845","full_name":"hummbl-dev/hummbl","owner":"hummbl-dev","description":"Highly Useful Mental Model Base Language (HUMMBL)","archived":false,"fork":false,"pushed_at":"2025-11-27T18:37:33.000Z","size":1421,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-30T09:40:00.401Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://hummbl.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/hummbl-dev.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":"SECURITY_ACCESSIBILITY_PHASE1.md","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-20T17:07:09.000Z","updated_at":"2025-11-27T18:37:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/hummbl-dev/hummbl","commit_stats":null,"previous_names":["hummbl-dev/hummbl"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hummbl-dev/hummbl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hummbl-dev%2Fhummbl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hummbl-dev%2Fhummbl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hummbl-dev%2Fhummbl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hummbl-dev%2Fhummbl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hummbl-dev","download_url":"https://codeload.github.com/hummbl-dev/hummbl/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hummbl-dev%2Fhummbl/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28937874,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-31T08:53:31.997Z","status":"ssl_error","status_checked_at":"2026-01-31T08:51:38.521Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":[],"created_at":"2026-01-31T10:09:13.989Z","updated_at":"2026-01-31T10:09:15.389Z","avatar_url":"https://github.com/hummbl-dev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HUMMBL - Highly Useful Mental Model Base Language\n\nA comprehensive dashboard for managing agentic workflows with AI-powered agents, built with React, TypeScript, and modern web technologies.\n\n\u003e **🚧 Preview Build Notice**\n\u003e \n\u003e This is a **preview demonstration** of the HUMMBL interface and design system. The current deployment showcases:\n\u003e - ✅ Full UI/UX design and navigation\n\u003e - ✅ Workflow creation and editing interfaces (localStorage-based)\n\u003e - ✅ 120+ mental model framework database\n\u003e - ✅ Agent configuration and template system\n\u003e - ⏳ Workflow execution (coming in production release)\n\u003e - ⏳ Backend data persistence (coming in production release)\n\u003e - ⏳ Team collaboration features (coming in production release)\n\u003e\n\u003e **Try it now**: [https://hummbl.vercel.app](https://hummbl.vercel.app)\n\n## Overview\n\nHUMMBL is an intuitive workflow management system that allows you to create, configure, and monitor complex agentic workflows. Each workflow can contain multiple AI agents with specific roles and capabilities working together to accomplish tasks.\n\n## Features\n\n- **Authentication**: Secure sign in/sign up with session management and JWT tokens\n- **Workflow Management**: Create, edit, delete, and monitor workflows\n- **Agent Configuration**: Configure AI agents with specific roles, capabilities, and models\n- **Task Orchestration**: Define tasks with dependencies and execution flow\n- **Real-time Monitoring**: Track workflow execution with live status updates\n- **Template System**: Start quickly with pre-configured workflow templates\n- **Execution Logs**: Monitor detailed logs of workflow execution\n- **Modern UI**: Clean, responsive interface built with Tailwind CSS\n\n## Tech Stack\n\n### Frontend\n- **Framework**: React 18 with TypeScript\n- **Build Tool**: Vite\n- **Routing**: React Router v6\n- **State Management**: Zustand\n- **Styling**: Tailwind CSS\n- **Icons**: Lucide React\n- **Date Utilities**: date-fns\n\n### Backend\n- **Runtime**: Cloudflare Workers\n- **Framework**: Hono.js\n- **Database**: Cloudflare D1 (SQLite)\n- **Cache**: Cloudflare KV\n- **API Documentation**: OpenAPI 3.0 + Swagger UI\n\n## Quick Links\n\n- **Live App**: [https://hummbl.vercel.app](https://hummbl.vercel.app)\n- **Backend API**: [https://hummbl-backend.hummbl.workers.dev](https://hummbl-backend.hummbl.workers.dev)\n- **API Documentation**: [https://hummbl-backend.hummbl.workers.dev/api/docs](https://hummbl-backend.hummbl.workers.dev/api/docs) (Swagger UI)\n- **OpenAPI Spec**: [View YAML](https://hummbl-backend.hummbl.workers.dev/api/docs/openapi.yaml)\n\n## Documentation\n\n- **Authentication Guide**: See `AUTHENTICATION_GUIDE.md` for sign in/sign up implementation\n- **API Documentation**: See `workers/API_DOCUMENTATION.md` for complete API reference\n- **Testing Guide**: See `TESTING_AGENTS.md` for production testing\n- **Workflow Guide**: See `WORKFLOW_USAGE_GUIDE.md` for workflow concepts\n\n## Getting Started\n\n### Prerequisites\n\n- Node.js 18+ and npm/yarn/pnpm\n\n### Installation\n\n1. Clone the repository:\n```bash\ngit clone \u003crepository-url\u003e\ncd hummbl\n```\n\n2. Install dependencies:\n```bash\nnpm install\n```\n\n3. Start the development server:\n```bash\nnpm run dev\n```\n\n4. Open your browser and navigate to `http://localhost:3000`\n\n### Build for Production\n\n```bash\nnpm run build\n```\n\n### Preview Production Build\n\n```bash\nnpm run preview\n```\n\n## Project Structure\n\n```\nhummbl/\n├── src/\n│   ├── components/\n│   │   └── Layout/           # Layout components (Header, Sidebar)\n│   ├── data/\n│   │   └── templates.ts      # Workflow templates\n│   ├── pages/\n│   │   ├── Dashboard.tsx     # Main dashboard\n│   │   ├── WorkflowList.tsx  # Workflow listing\n│   │   ├── WorkflowDetail.tsx # Workflow details and monitoring\n│   │   ├── WorkflowEditor.tsx # Create/edit workflows\n│   │   ├── AgentManagement.tsx # Agent configuration\n│   │   └── Templates.tsx     # Template browser\n│   ├── store/\n│   │   └── workflowStore.ts  # Zustand state management\n│   ├── types/\n│   │   └── workflow.ts       # TypeScript type definitions\n│   ├── App.tsx               # Main application component\n│   ├── main.tsx              # Application entry point\n│   └── index.css             # Global styles\n├── index.html                # HTML entry point\n├── package.json\n├── tsconfig.json\n├── vite.config.ts\n└── tailwind.config.js\n```\n\n## Usage Guide\n\n### Creating a Workflow\n\n1. Navigate to the **Workflows** page\n2. Click **New Workflow**\n3. Enter workflow details (name, description, tags)\n4. Save the workflow\n\n### Managing Agents\n\n1. Go to the **Agents** page\n2. Click **New Agent**\n3. Configure agent properties:\n   - Name and role\n   - Description\n   - Capabilities\n   - Model settings (model, temperature, max tokens)\n4. Save the agent\n\n### Using Templates\n\n1. Visit the **Templates** page\n2. Browse available templates by category\n3. Click **Use This Template**\n4. Enter a name for your new workflow\n5. The workflow will be created with pre-configured agents and tasks\n\n### Monitoring Workflows\n\n1. Click on a workflow from the **Workflows** page\n2. View workflow status, progress, and tasks\n3. Start, pause, or stop workflow execution\n4. Monitor execution logs in real-time\n\n## Workflow Concepts\n\n### Workflows\n\nA workflow is a collection of tasks executed by agents to achieve a specific goal. Each workflow has:\n- **Status**: draft, active, paused, completed, or failed\n- **Tasks**: Individual units of work\n- **Agents**: AI agents that execute tasks\n- **Metadata**: Tags, timestamps, and custom data\n\n### Agents\n\nAgents are AI-powered entities that perform tasks. Each agent has:\n- **Role**: researcher, analyst, executor, reviewer, or custom\n- **Capabilities**: List of what the agent can do\n- **Model Configuration**: AI model, temperature, and token limits\n\n### Tasks\n\nTasks are individual steps in a workflow. Each task includes:\n- **Dependencies**: Other tasks that must complete first\n- **Agent Assignment**: Which agent executes the task\n- **Status Tracking**: pending, running, completed, failed, or skipped\n- **Retry Logic**: Automatic retry on failure\n\n### Templates\n\nPre-configured workflows with agents and tasks ready to use:\n- **Research \u0026 Analysis Pipeline**: Multi-stage research workflow\n- **Content Creation Workflow**: Writing, editing, and SEO optimization\n- **Data Processing Pipeline**: ETL workflow with validation\n- **Automated Code Review**: Multi-agent code quality analysis\n\n## API / State Management\n\nThe application uses Zustand for state management. Key store methods:\n\n### Workflow Operations\n- `addWorkflow(workflow)`: Create new workflow\n- `updateWorkflow(id, updates)`: Update existing workflow\n- `deleteWorkflow(id)`: Delete workflow\n- `getWorkflow(id)`: Retrieve workflow by ID\n\n### Agent Operations\n- `addAgent(agent)`: Create new agent\n- `updateAgent(id, updates)`: Update agent\n- `deleteAgent(id)`: Delete agent\n- `getAgent(id)`: Retrieve agent by ID\n\n### Execution Operations\n- `startWorkflow(id)`: Start workflow execution\n- `pauseWorkflow(id)`: Pause workflow\n- `stopWorkflow(id)`: Stop workflow\n\n### Log Operations\n- `addLog(log)`: Add execution log\n- `getWorkflowLogs(workflowId)`: Get logs for workflow\n\n## Customization\n\n### Adding New Templates\n\nEdit `src/data/templates.ts` to add custom workflow templates:\n\n```typescript\n{\n  id: 'my-template',\n  name: 'My Custom Template',\n  description: 'Template description',\n  category: 'Custom',\n  tags: ['tag1', 'tag2'],\n  agents: [/* agent configs */],\n  tasks: [/* task configs */]\n}\n```\n\n### Styling\n\nThe application uses Tailwind CSS. Custom styles are defined in:\n- `src/index.css`: Global styles and custom components\n- `tailwind.config.js`: Theme configuration\n\n## CI/CD\n\nThis project uses GitHub Actions for continuous integration and deployment.\n\n### Workflows\n\n- **CI** (`ci.yml`): Runs on all pushes and PRs, tests across Node.js 18, 20, and 22\n- **Azure Deploy** (`azure-deploy.yml`): Deploys to Azure Web Apps on main branch updates\n\n### Fixing Old Workflow Failures\n\nIf you see failing workflows for Grunt or other legacy build systems:\n\n1. Go to your repository on GitHub\n2. Navigate to **Settings** → **Actions** → **General**\n3. Scroll to **Workflow permissions** and disable unwanted workflows\n4. Or go to **Actions** tab, select the failing workflow, and disable it\n\nThe proper workflows are now configured in `.github/workflows/` for the Vite build system.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nMIT License - see LICENSE file for details\n\n## Support\n\nFor issues and questions, please open an issue on the GitHub repository.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhummbl-dev%2Fhummbl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhummbl-dev%2Fhummbl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhummbl-dev%2Fhummbl/lists"}