Skip to content

SETUP_GITHUB.md

Latest commit

 

History

History
265 lines (188 loc) · 5.74 KB

SETUP_GITHUB.md

File metadata and controls

265 lines (188 loc) · 5.74 KB
Raw

GitHub Repository Configuration for Hermes Evolution

Repository Settings

Basic Information

Name: hermes-agent-evolution

Description: Self-evolving AI Agent with autonomous research, proposal generation, and self-update capabilities based on Hermes Agent by Nous Research

Website: https://github.com/nousresearch/hermes-agent (upstream)

Topics:

ai-agent, artificial-intelligence, autonomous-agent, self-improving-ai, 
llm, multi-agent, research, automation, evolution, hermes-agent, 
python, cron-job, automation-tools, self-updating

Repository Visibility

  • Visibility: Public
  • Enable Issues: Yes
  • Enable Projects: Yes
  • Enable Wiki: No (use docs instead)
  • Enable Discussions: Yes

Branch Protection

For main branch:

  1. Require status checks:

    • Require branches to be up to date before merging
    • Require status checks to pass before merging
    • Required checks: tests, lint

  2. Require pull request reviews:

    • Approvals required: 1
    • Dismiss stale reviews: Yes
    • Require review from CODEOWNERS: Yes

  3. Restrict who can push:

    • Only allow repository owner to push
    • Allow force pushes: No

  4. Additional protections:

    • Do not allow bypassing settings: Yes
    • Require linear history: Yes

Tags

Create initial tags:

git tag -a v0.1.0 -m "Initial release with evolution capabilities"
git push origin v0.1.0

Labels

Create custom labels:

Evolution Labels:

  • evolution - Evolution-related issues
  • automated - Automatically generated issues
  • proposal - Feature proposals from research
  • upstream-sync - Issues related to upstream sync

Priority Labels:

  • priority:critical - Critical priority
  • priority:high - High priority
  • priority:medium - Medium priority
  • priority:low - Low priority

Mode Labels:

  • public-mode - Works in PUBLIC mode
  • private-mode - Requires PRIVATE mode
  • mode-specific - Mode-specific behavior

Status Labels:

  • needs-triage - Needs triage
  • needs-review - Needs review
  • approved - Approved for implementation
  • rejected - Rejected

Milestones

Create milestones:

v0.2.0 - Enhanced Evolution:

  • Improved research algorithms
  • Better priority scoring
  • Enhanced upstream sync

v0.3.0 - Advanced Evolution:

  • Multi-agent research collaboration
  • Automatic feature detection
  • Predictive evolution

Security & Analysis

Enable:

  • Security advisories: Yes
  • Dependabot alerts: Yes
  • Dependabot security updates: Yes
  • Code security alerts: Yes
  • Secret scanning: Yes

Features

Enable:

  • Actions: Yes (for workflows)
  • Pages: No (not needed)
  • Packages: No (not needed)

Collaborators

Initially:

  • Owner: Lexus2016 (admin)

Future:

  • Invite collaborators as needed
  • Assign roles based on contribution

Integration Settings

GitHub Actions:

Enable workflows:

  • .github/workflows/research.yml (if added)
  • Tests workflow (to be added)
  • Lint workflow (to be added)

Third-party:

  • None initially

Webhooks

Initially: None

Future:

  • Webhook for deployment notifications
  • Webhook for monitoring

Post-Setup Checklist

After creating the repository on GitHub:

Step 1: Update Remote

cd /Users/admin/_Projects/hermes-agent-evolution
git remote set-url origin https://github.com/Lexus2016/hermes-agent-evolution.git
git remote -v

Step 2: Push to GitHub

git push -u origin main
git push origin --tags

Step 3: Configure Repository

  1. Go to repository Settings on GitHub
  2. Set description and topics (see above)
  3. Configure branch protection for main branch
  4. Create custom labels (see above)
  5. Create milestones
  6. Enable security features
  7. Configure branch rules

Step 4: Create Initial Release

  1. Go to "Releases" → "Create a new release"
  2. Tag: v0.1.0
  3. Title: v0.1.0 - Initial Evolution Release
  4. Description:
## v0.1.0 - Initial Evolution Release

### Features
- Self-evolution framework
- Research capabilities
- Issue/PR generation
- Analysis and prioritization
- Upstream sync

### Skills Added
- evolution/research
- evolution/issues
- evolution/analysis
- evolution/implementation
- evolution/upstream-sync

### Cron Jobs
- Daily research (9 AM)
- Daily issue creation (12 PM)
- Daily analysis (9 PM, PRIVATE)
- Daily implementation (10 PM, PRIVATE)
- Weekly upstream sync (Sunday 8 AM, PRIVATE)

### Documentation
- EVOLUTION_README.md
- CONTRIBUTING_EVOLUTION.md
- CODE_OF_CONDUCT.md
- SECURITY_EVOLUTION.md

### Known Issues
- Manual setup required for GitHub tokens
- Upstream sync requires manual review

### Next Release
- Improved automation
- Better testing
- Enhanced documentation

Step 5: Create Documentation Pages

  1. Enable GitHub Pages (optional)
  2. Create documentation site if needed
  3. Link to documentation in README

Step 6: Social/Community

  1. Star the repository
  2. Add to relevant lists
  3. Announce in relevant communities
  4. Add to awesome lists if applicable

Manual GitHub Tasks

These need to be done manually on GitHub:

Repository Description

Copy this to repository description:

Self-evolving AI Agent with autonomous research, proposal generation, and self-update capabilities. Fork of Hermes Agent by Nous Research with evolution capabilities.

Topics

Add these topics (comma-separated):

ai-agent, artificial-intelligence, autonomous-agent, self-improving-ai, llm, multi-agent-system, research, automation, python, cron, hermes-agent, auto-update, autonomous-research, agent-architecture

Homepage

Set to: https://hermes-agent.nousresearch.com

License

Set to: Apache License 2.0

After completing all steps, your repository will be fully configured and ready for evolution! 🚀