{"id":50411513,"url":"https://github.com/geramy/nexus-project-client","last_synced_at":"2026-06-15T05:01:33.384Z","repository":{"id":361511963,"uuid":"1254721798","full_name":"Geramy/nexus-project-client","owner":"Geramy","description":"Nexus Projects — source-available Application for AI-coordinated project \u0026 task management (text + voice Coordinator, plans, tasks, agents).","archived":false,"fork":false,"pushed_at":"2026-06-07T05:16:28.000Z","size":3441,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-07T05:19:38.794Z","etag":null,"topics":["ai","ai-agents","ai-tools","code","harness","programming","project-management","task-manager"],"latest_commit_sha":null,"homepage":"https://www.nexus-projects.ai/Home/Projects","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Geramy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2026-05-30T23:33:07.000Z","updated_at":"2026-06-07T05:16:30.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Geramy/nexus-project-client","commit_stats":null,"previous_names":["geramy/nexus-project-client"],"tags_count":48,"template":false,"template_full_name":null,"purl":"pkg:github/Geramy/nexus-project-client","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Geramy%2Fnexus-project-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Geramy%2Fnexus-project-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Geramy%2Fnexus-project-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Geramy%2Fnexus-project-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Geramy","download_url":"https://codeload.github.com/Geramy/nexus-project-client/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Geramy%2Fnexus-project-client/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34348292,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-15T02:00:07.085Z","response_time":63,"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":["ai","ai-agents","ai-tools","code","harness","programming","project-management","task-manager"],"created_at":"2026-05-31T04:00:32.170Z","updated_at":"2026-06-15T05:01:33.271Z","avatar_url":"https://github.com/Geramy.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nexus Projects (Client)\n\nA production-grade, multi-tenant Flutter client for managing complex projects with AI coordination, agentic task execution, Git integration, CI/CD, and observability.\n\n## Vision\n\nNexus Projects gives teams (and individuals) a powerful environment where:\n\n- **Clients** act as top-level tenants (full data isolation + sharing via \"Clone to Client\").\n- **Projects** contain rich plans that drive hierarchical task generation.\n- The **Project Coordinator** (the \"main brain\") can be talked to via **text or voice**, sees full project context, and can directly create/update tasks, propose plan changes, and generate diagrams using real multi-modal capabilities.\n- Real **AEC + VAD** voice processing for natural, hands-free conversations.\n- Full agentic workflows with inference servers, personas, tool calling, and live reactive updates.\n\n## Architecture: Router + Client\n\nNexus Projects is two cooperating components — a server-side **Router** and this user-facing **Client**.\n\n### Nexus Router (server)\n\nA separate, multi-tenant gateway service (C#/.NET) that sits in front of all AI inference. It is the billing\nand access-control brain of the system:\n\n- **Authentication \u0026 tenancy** — registration, login, and API tokens, organized as a tenant chain of\n  **Client → Account → Users → Tokens** with strict data isolation.\n- **Subscriptions \u0026 billing** — subscription plans and add-ons backed by Stripe, with checkout and\n  manage-billing flows.\n- **Metering \u0026 quotas** — every routed inference request is measured against the account's entitlements for\n  the current Stripe billing period. Going over quota does not hard-fail requests; instead output is paced\n  (throttled) and an upgrade prompt is surfaced, so the app keeps working.\n- **Inference proxy** — chat, tools, image, and audio (STT/TTS) requests are proxied through the Router to\n  the underlying inference backends, so usage can be authenticated and billed centrally.\n\nThe Router is closed-source and operated by Nexus Projects; this repository contains the Client only.\n\n### Nexus Projects Client (this repo)\n\nThe Flutter desktop/mobile application — the project workspace, the AI **Coordinator**, plans, tasks, and\nagents. The Client connects to the Nexus Router for **authentication, subscription/billing, and routed\ninference**. The account surface in the Client (login, register, plan catalog, usage meter, checkout) is the\nfront end to the Router's subscription system; it is not a standalone billing implementation and is not meant\nto be repointed at any other gateway.\n\nIn short: the **Router decides who may use inference and bills for it; the Client is where the work happens**\nand is the customer-facing front end to that subscription system.\n\n## Key Features (Current State)\n\n- **Strict multi-tenancy** — Client selector scopes everything (projects, tasks, inference servers, personas, activity, etc.).\n- **Project Coordinator** (the signature feature):\n  - Rich text chat with live project context.\n  - Voice mode with automatic end-of-speech detection (real Silero VAD).\n  - Proper OS-level AEC and noise suppression via `audio_session` + platform voice communication modes.\n  - The AI can call tools to **create tasks**, **update status**, **propose plan adjustments**, and **generate diagrams** — changes persist immediately and reflect in the UI.\n- **One class per file** architecture with clean separation (`infrastructure/models/database` vs `ui`, `features/...`).\n- Reactive Drift + Riverpod throughout.\n- Supports streaming, tools, image generation, and audio (STT/TTS).\n- 3-pane resizable shell with proper default proportions.\n\n## Screenshots\n\n#### Project setup, driven by an interview\nThe Coordinator interviews you about the project with short multiple-choice questions and proposes tags onto the board as you talk — turning a conversation into a structured stack (Industries, Platforms, Objectives, Features, Languages, Frameworks, Libraries). The left rail scopes everything by **Client → Project**.\n\n![Project setup board](screenshots/02-project-setup-navigation.jpg)\n\n#### The Coordinator interview — text or voice\nAnswer by typing, or go hands-free. Real Silero VAD with end-of-speech detection and OS-level echo cancellation lets you talk to the Coordinator naturally while it fills in the board live.\n\n![Setup interview](screenshots/10-setup-interview.jpg)\n![Voice setup interview](screenshots/11-setup-interview-voice.jpg)\n\n#### Living plans\nGenerated plans are living Markdown documents (Overview, Client, Server, Database) that every layer shares as project-wide context. Choose the Coordinator agent that owns each plan.\n\n![Plan editor](screenshots/12-plan-editor.jpg)\n\n#### Hierarchical tasks with a rich detail panel\nEach task has Overview, Sub-Tasks, Git Changes, Agent Work, and Builds \u0026 CI tabs. Status, priority, dates, and assigned agent persist live.\n\n![Task detail](screenshots/03-task-detail.jpg)\n\n#### Agents \u0026 personas\nA roster of specialized agent personas — Project Manager, Coordinator, and SDE specialists (Generalist, Networking, Physics, Database, UI/UX, DevOps) plus a Verification agent — each backed by a configurable model.\n\n![Agents and personas](screenshots/04-agents-personas.jpg)\n\n#### Bring your own inference\nAutomatic LAN discovery of Lemonade inference servers alongside your configured providers — pick the model that runs each agent.\n\n![AI providers](screenshots/05-ai-providers.jpg)\n\n#### Code \u0026 Git, in app\nAn integrated workspace with Git — commit, push, pull, merge, branch, and history — plus an editor and source-control view over your project's plans and code.\n\n![Code and Git](screenshots/06-code-and-git.jpg)\n\n#### Build \u0026 package from the app\nDocker-backed build environments, images, and containers with live build logs.\n\n![Launch and packaging](screenshots/07-launch-packaging.jpg)\n\n#### Account, usage \u0026 subscription\nUsage is metered against your plan for the billing period; going over quota **paces** output instead of hard-failing. Plans run from Basic to Platinum with optional add-ons.\n\n![Account and usage](screenshots/08-account-usage.jpg)\n![Plans](screenshots/09-account-plans.jpg)\n\n## Project Structure\n\n```\nnexus_projects_client/\n├── lib/\n│   ├── features/\n│   │   ├── projects/          # Coordinator chat + session (core voice work)\n│   │   ├── project_plans/\n│   │   ├── tasks/\n│   │   └── ...\n│   ├── infrastructure/\n│   │   ├── inference/         # InferenceClient (chat, tools, image, audio)\n│   │   ├── database/\n│   │   └── models/\n│   └── services/audio/        # AEC, VAD, recorder, TTS\n├── packaging/                 # Windows Inno Setup installer script\n├── .github/workflows/         # CI + desktop build + release pipelines\n└── README.md\n```\n\n## Getting Started\n\n```bash\nflutter pub get\ndart run build_runner build --delete-conflicting-outputs\nflutter run -d macos   # or your preferred device\n```\n\n### Voice / Microphone\n\nOn first use you will be prompted for microphone permission. The app uses proper voice communication audio modes for echo cancellation when talking to the Coordinator.\n\n## Technology\n\n- Flutter + Riverpod + Freezed + Drift (reactive SQLite)\n- GoRouter\n- Dio (with full streaming + tool call assembly)\n- `record` + `just_audio` + `audio_session` + `vad` (for high-quality voice)\n\n## Contributing / Philosophy\n\nWe follow extremely strict organization rules:\n- One class per file\n- Clear separation between database models and UI models\n- All new major features (especially anything touching the Coordinator) must live in their own well-named files under `features/` or `services/`\n\n## License \u0026 Usage\n\nThe Nexus Projects Client is **source-available** under the Sustainable Use License with Additional Use\nRestrictions — see [`LICENSE.md`](LICENSE.md) for the full terms. It is source-available, not OSI \"open\nsource.\" The following restrictions are central:\n\n- **The subscription system on the Client may not be modified or replaced — at all.** You may not alter,\n  reconfigure, bypass, or substitute your own subscription, billing, entitlement, or metering logic, and you\n  may not point the Client at any inference/billing gateway other than the official **Nexus Router**.\n- **The only permitted alternative is to remove the subscription system entirely** — i.e. ship a build that\n  contains no subscription, billing, or entitlement functionality whatsoever. There is no middle ground:\n  either keep the official subscription system and Router unchanged, or have none of it. Building your own in\n  its place is not allowed.\n- The **login / registration (authentication)** system likewise may not be modified to authenticate against\n  any service other than the official Nexus services.\n\n### Commercial use of the Router / subscription system\n\nIf you want to use the Nexus Router or its subscription/billing routing **commercially**, that is available\nunder a separate commercial license — please get in touch at **support@nexus-projects.ai** to arrange it.\n\n**Organization exceptions:** **Lemonade-sdk** is permitted to use the Router through an existing partnership.\nNo other organization has this exception except by separate written agreement.\n\n---\n\nBuilt iteratively with a strong focus on real agentic workflows and natural voice interaction with your project's \"main brain\".\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeramy%2Fnexus-project-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgeramy%2Fnexus-project-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeramy%2Fnexus-project-client/lists"}