https://github.com/sofvanh/mindmeld
AI-assisted group deliberation
https://github.com/sofvanh/mindmeld
collective-intelligence deliberation
Last synced: about 1 month ago
JSON representation
AI-assisted group deliberation
- Host: GitHub
- URL: https://github.com/sofvanh/mindmeld
- Owner: sofvanh
- License: gpl-3.0
- Created: 2024-09-11T10:43:48.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-05-07T16:53:32.000Z (about 1 month ago)
- Last Synced: 2025-05-08T00:54:37.711Z (about 1 month ago)
- Topics: collective-intelligence, deliberation
- Language: TypeScript
- Homepage: https://nexus-tool.com
- Size: 1.01 MB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Nexus (formerly MindMeld)
> **Note**: We're in the process of renaming the project from MindMeld to Nexus. Some parts of the codebase and documentation still use the old name.
Nexus is a full-stack application designed to facilitate group deliberation using AI. It draws inspiration from platforms like [Polis](https://pol.is/home) and [Community Notes by X](https://www.lesswrong.com/posts/sx9wTyCp5kgy8xGac/community-notes-by-x). You can access the deployment [here](https://nexus-tool.com).
## Development Setup
1. **Install Dependencies**
```bash
npm run install:all # Installs both frontend and backend dependencies
```
2. **Environment Variables**
- Frontend (`.env` in frontend/):
- `REACT_APP_OAUTH_CLIENT_ID`: Google OAuth client ID
- `REACT_APP_BACKEND_URL`: Defaults to http://localhost:3001; Has to be set for production
- Backend (`.env` in backend/):
- `DB_USER`: Database username
- `DB_HOST`: Database host
- `DB_NAME`: Database name
- `DB_PASSWORD`: Database password
- `OPENAI_API_KEY`: OpenAI API key
- `GOOGLE_CLIENT_ID`: Google OAuth client ID (same as frontend)
3. **Run Development Servers**
```bash
npm run dev # Starts both frontend (port 3000) and backend (port 3001)
```
For detailed commands related to individual frontend or backend tasks, refer to the `package.json` files in their respective directories.
## Design
The branding and design system documentation can be found at `/design`. You can view it live [here](https://nexus-tool.com/design).
## Deployment
- **Frontend**: Automatically deployed to Netlify
- **Backend**: Automatically deployed to Google Cloud Run via GitHub Actions
## Docker Development
Build and run the development container:
```bash
cd backend
docker build -f Dockerfile.dev -t mindmeld-backend-dev .
docker run -p 3001:3001 -v $(pwd):/app mindmeld-backend-dev
```
## Useful Commands
View Cloud Run logs:
```bash
gcloud run services logs read mindmeld --project=mindmeld-backend
```
List container images:
```bash
gcloud container images list
```