fcea8afa6c
* change the package to workspace concept * add provider name and change default model * add the node_modules to git ignore * change the npm runs to use workspace * fix the start scripts to use the workspace * update the uv.lock * updated instructions * update the docker build to use the npm workspace * Update package-lock.json after merge to sync workspace dependencies * fix merge conflict
77 lines
1.4 KiB
Markdown
77 lines
1.4 KiB
Markdown
# Contributing to Hindsight
|
|
|
|
Thanks for your interest in contributing to Hindsight!
|
|
|
|
## Getting Started
|
|
|
|
1. Fork and clone the repository
|
|
```bash
|
|
git clone git@github.com:vectorize-io/hindsight.git
|
|
cd hindsight
|
|
```
|
|
2. Set up your environment:
|
|
```bash
|
|
cp .env.example .env
|
|
```
|
|
Edit the .env to add LLM API key and config as required
|
|
|
|
3. Install dependencies:
|
|
```bash
|
|
# Python dependencies
|
|
uv sync --directory hindsight-api/
|
|
|
|
# Node dependencies (uses npm workspaces)
|
|
npm install
|
|
```
|
|
|
|
## Development
|
|
|
|
### Running the API locally
|
|
|
|
```bash
|
|
./scripts/dev/start-api.sh
|
|
```
|
|
|
|
### Running the Control Plane locally
|
|
|
|
```bash
|
|
./scripts/dev/start-control-plane.sh
|
|
```
|
|
|
|
### Running the documentation locally
|
|
|
|
```bash
|
|
./scripts/dev/start-docs.sh
|
|
```
|
|
|
|
### Running tests
|
|
|
|
```bash
|
|
cd hindsight-api
|
|
uv run pytest tests/
|
|
```
|
|
|
|
### Code style
|
|
|
|
- Use Python type hints
|
|
- Follow existing code patterns
|
|
- Keep functions focused and well-named
|
|
|
|
## Pull Requests
|
|
|
|
1. Create a feature branch from `main`
|
|
2. Make your changes
|
|
3. Run tests to ensure nothing breaks
|
|
4. Submit a PR with a clear description of changes
|
|
|
|
## Reporting Issues
|
|
|
|
Open an issue on GitHub with:
|
|
- Clear description of the problem
|
|
- Steps to reproduce
|
|
- Expected vs actual behavior
|
|
- Environment details (OS, Python version)
|
|
|
|
## Questions?
|
|
|
|
Open a discussion on GitHub or reach out to the maintainers.
|