SyslogSolution/ra-h-os
7
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial commit: RA-H Open Source Edition

Browse Source 
Local-first knowledge management system with BYO API keys.

Features:
- 3-panel UI (Nodes | Focus | Helpers)
- SQLite + sqlite-vec for vector search
- Agent system (Easy/Hard mode orchestrators)
- Content extraction (YouTube, PDF, web)
- Integrate workflow for connection discovery
- Dimension system with auto-assignment

Tech stack:
- Next.js 15 + TypeScript + Tailwind CSS
- Anthropic (Claude) + OpenAI (GPT) via Vercel AI SDK

Setup:
  npm install && npm rebuild better-sqlite3
  scripts/dev/bootstrap-local.sh
  npm run dev

MIT License
This commit is contained in:
“BeeRad”
2025-12-15 16:14:28 +11:00
commit 733d1c3407
226 changed files with 46231 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.github/ISSUE_TEMPLATE/bug_report.md
+53
View File
@@ -0,0 +1,53 @@
---
name: Bug report
about: Create a report to help us improve
title: '[BUG] '
labels: bug
assignees: ''
---
## Bug Description
A clear and concise description of what the bug is.
## Steps to Reproduce
Steps to reproduce the behavior:
1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error
## Expected Behavior
A clear and concise description of what you expected to happen.
## Actual Behavior
A clear and concise description of what actually happened.
## Screenshots
If applicable, add screenshots to help explain your problem.
## Environment
- OS: [e.g., macOS 13.5, Ubuntu 22.04, Windows 11]
- Node.js Version: [e.g., 18.17.0]
- Browser: [e.g., Chrome 115, Firefox 116, Safari 16.6]
- RA-H Version: [e.g., 0.1.0]
## Database Information
- PostgreSQL Version: [if known]
- Docker Version: [if using Docker]
- Any error messages from database logs
## Additional Context
- Error messages (include full stack traces if available)
- Console output
- Network tab information (if API-related)
- Any other context about the problem
## Possible Solution
If you have ideas on how to fix the issue, please describe them here.
## Checklist
- [ ] I have searched existing issues to ensure this is not a duplicate
- [ ] I have provided all the requested information
- [ ] I can reproduce this issue consistently
- [ ] I have included error messages and logs where applicable
.github/ISSUE_TEMPLATE/feature_request.md
+52
View File
@@ -0,0 +1,52 @@
---
name: Feature request
about: Suggest an idea for this project
title: '[FEATURE] '
labels: enhancement
assignees: ''
---
## Problem Statement
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
## Proposed Solution
A clear and concise description of what you want to happen.
## Alternative Solutions
A clear and concise description of any alternative solutions or features you've considered.
## Use Cases
Describe specific use cases where this feature would be helpful:
1. Use case 1: [description]
2. Use case 2: [description]
## Implementation Ideas
If you have ideas on how this could be implemented, please describe them:
- Frontend changes needed
- Backend/API changes needed
- Database schema changes
- New dependencies required
## Priority
How important is this feature to you?
- [ ] Nice to have
- [ ] Important for my workflow
- [ ] Critical for adoption
## Mockups/Examples
If applicable, add mockups, wireframes, or examples to help explain your request.
## Additional Context
Add any other context, links to similar features in other apps, or screenshots about the feature request here.
## Acceptance Criteria
What would need to be true for this feature to be considered complete?
- [ ] Criteria 1
- [ ] Criteria 2
- [ ] Criteria 3
## Related Issues
Are there any existing issues that relate to this request?
- Fixes #
- Related to #
.github/pull_request_template.md
+125
View File
@@ -0,0 +1,125 @@
# Pull Request
## Description
Brief description of what this PR does and why.
## Type of Change
Please delete options that are not relevant.
- [ ] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
- [ ] Documentation update
- [ ] Code refactoring (no functional changes)
- [ ] Performance improvement
- [ ] Test coverage improvement
## Related Issues
Closes #[issue number]
Related to #[issue number]
## Changes Made
- [ ] Change 1: Description
- [ ] Change 2: Description
- [ ] Change 3: Description
## How Has This Been Tested?
Please describe the tests that you ran to verify your changes:
- [ ] Unit tests
- [ ] Integration tests
- [ ] Manual testing
- [ ] API endpoint testing (if applicable)
- [ ] Database operations verified
- [ ] UI/UX testing (if applicable)
### Test Configuration
- Node.js version: [e.g., 18.17.0]
- Operating System: [e.g., macOS 13.5]
- Database: [e.g., PostgreSQL 15 with pgvector]
## Screenshots/Videos
If applicable, add screenshots or videos to demonstrate the changes.
### Before
[Screenshot/description of before state]
### After
[Screenshot/description of after state]
## Database Changes
- [ ] No database changes
- [ ] Schema changes (describe below)
- [ ] Migration required
- [ ] Seeds/fixtures updated
If database changes are made, describe them:
```sql
-- Example of schema changes
```
## API Changes
- [ ] No API changes
- [ ] New endpoints added
- [ ] Existing endpoints modified
- [ ] Breaking changes to API
If API changes are made, describe them:
```typescript
// Example of API changes
```
## Performance Impact
- [ ] No performance impact expected
- [ ] Performance improvement
- [ ] Potential performance impact (explain below)
## Security Considerations
- [ ] No security implications
- [ ] Security improvement
- [ ] Potential security impact (explain below)
## Documentation
- [ ] Documentation updated
- [ ] No documentation changes needed
- [ ] Documentation to be updated in separate PR
## Checklist
- [ ] My code follows the style guidelines of this project
- [ ] I have performed a self-review of my code
- [ ] I have commented my code, particularly in hard-to-understand areas
- [ ] I have made corresponding changes to the documentation
- [ ] My changes generate no new warnings or errors
- [ ] I have added tests that prove my fix is effective or that my feature works
- [ ] New and existing unit tests pass locally with my changes
- [ ] Any dependent changes have been merged and published
## Deployment Notes
Special instructions for deploying this change:
- [ ] No special deployment requirements
- [ ] Environment variables need to be updated
- [ ] Database migration required
- [ ] External service configuration needed
## Breaking Changes
If this introduces breaking changes, describe the migration path:
## Additional Notes
Any additional information that reviewers should know:
---
## For Reviewers
### Review Focus Areas
Please pay special attention to:
- [ ] Code quality and style
- [ ] Test coverage
- [ ] Performance implications
- [ ] Security considerations
- [ ] Documentation accuracy
### Testing Instructions
Specific steps for reviewers to test this change:
1. Step 1
2. Step 2
3. Step 3