{"id":25906886,"url":"https://github.com/blossomlabs/councilhaus","last_synced_at":"2025-03-03T06:16:02.980Z","repository":{"id":255539688,"uuid":"851597742","full_name":"BlossomLabs/CouncilHaus","owner":"BlossomLabs","description":"Continuous and participatory budget allocation dApp","archived":false,"fork":false,"pushed_at":"2025-01-23T12:51:54.000Z","size":1549,"stargazers_count":1,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"dev","last_synced_at":"2025-01-23T13:39:45.176Z","etag":null,"topics":["council","dao","governance","superfluid"],"latest_commit_sha":null,"homepage":"https://council.haus","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BlossomLabs.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":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-03T11:43:25.000Z","updated_at":"2024-11-17T09:31:10.000Z","dependencies_parsed_at":"2024-09-06T00:57:59.293Z","dependency_job_id":"79359518-2f4d-4fe8-840c-b85de1ae485a","html_url":"https://github.com/BlossomLabs/CouncilHaus","commit_stats":null,"previous_names":["blossomlabs/councilhaus"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlossomLabs%2FCouncilHaus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlossomLabs%2FCouncilHaus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlossomLabs%2FCouncilHaus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlossomLabs%2FCouncilHaus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BlossomLabs","download_url":"https://codeload.github.com/BlossomLabs/CouncilHaus/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241616673,"owners_count":19991543,"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","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":["council","dao","governance","superfluid"],"created_at":"2025-03-03T06:16:02.322Z","updated_at":"2025-03-03T06:16:02.973Z","avatar_url":"https://github.com/BlossomLabs.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CouncilHaus: A Continuous and Participatory Budget Allocation dApp [![Coverage Status](https://coveralls.io/repos/github/BlossomLabs/councilhaus/badge.svg?branch=master\u0026dummy=unused)](https://coveralls.io/github/BlossomLabs/councilhaus?branch=master)\n\n\n## What is CouncilHaus?\n\nCouncilHaus enables organizations with a set budget to allocate funds continuously among grantees. Council members vote to decide how the budget is distributed dynamically, ensuring efficient use of resources, reducing administrative overhead, and allowing real-time adjustments to meet evolving needs.\n\n![](https://ipfs.blossom.software/ipfs/QmS39MkssLK2Tvv63NK7aYVmyDsDGJCJ2LEtBSr1saisK4)\n\n## Key Features\n\n1. **Participatory Decision Making**: Council members actively decide how funds are distributed, fostering a more inclusive allocation process.\n2. **Flexible Allocation**: Members can allocate their voting power across multiple grantees, supporting various projects as they see fit.\n3. **Transparent Process**: All allocations and decisions are recorded, providing a clear and auditable trail of fund distribution.\n4. **Managed Access**: The system includes roles for administering members and grantees, maintaining control over who can participate.\n5. **Automatic Distribution**: Once allocations are decided, the system automatically handles the distribution of funds to grantees.\n\n## How It Works\n\n1. **Council Formation**: Administrators can add council members, assigning them voting power based on their role or expertise.\n2. **Grantee Registration**: Potential fund recipients (grantees) are added to the system.\n3. **Budget Allocation**: Council members use their voting power to allocate funds to grantees they wish to support.\n4. **Automatic Distribution**: Once allocations are set, the system takes care of distributing the funds according to the council's decisions.\n\n## Why Use CouncilHaus?\n\nCouncilHaus brings several benefits to organizations looking to manage grant or fund allocation:\n\n- **Participation**: Encourages active involvement by recognizing and rewarding contributions, creating a more engaged, motivated, and thriving community.\n- **Flexibility**: Council members can easily adjust their allocations, responding to changing needs or priorities.\n- **Efficiency**: The automated distribution system reduces administrative overhead.\n- **Transparency**: All decisions are recorded, promoting trust and accountability.\n\nWhether you're a company, a DAO interested in funding an ecosystem of contributors, a public-goods organization,  or any entity that needs to manage collective fund allocation, CouncilHaus offers a modern, flexible, and efficient solution to empower your team and streamline grant-giving. For instance, Superfluid has used CouncilHaus to reward ecosystem contributors in an ongoing hackathon, with demo days every two weeks.\n\n## How to run\n\nInstall bun (a fast JavaScript runtime) from [https://bun.sh/](https://bun.sh/) or just use `npm install -g bun`.\n\nUse `bun` to install dependencies and run the project:\n\n```bash\nbun install\nbun run dev\n```\n\nThe development server will be available at http://localhost:3000/.\n\nThe smart contracts are in the `contracts` directory, and the frontend is in the `apps` directory.\n\n## How to deploy\n\n### Build Settings\n\n- **Docker Image:**\n  `node:lts`\n\n- **Repository:**  \n  [https://github.com/BlossomLabs/councilhaus](https://github.com/BlossomLabs/councilhaus)\n\n- **Build Command:**  \n  ```bash\n  npm install -g bun \u0026\u0026 HUSKY=0 bun i \u0026\u0026 bun run --cwd apps/web/ build\n  ```\n\n- **Publish Directory:**  \n  `apps/web/build/client`\n\n### Environment Variables\n\n- Use `VITE_WALLETCONNECT_PROJECT_ID` for your wallet connect project ID.\n- Use `VITE_SITE_URL` for your site URL. Otherwise, the default will be `https://council.haus`.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblossomlabs%2Fcouncilhaus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblossomlabs%2Fcouncilhaus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblossomlabs%2Fcouncilhaus/lists"}