braiins-os

# Braiins OS

Comprehensive skill for Braiins OS - Bitcoin mining ASIC firmware covering API integration, OS feeds, and official documentation.

## Description

This skill provides complete coverage of the Braiins OS ecosystem, including:

- **BOS+ API** - REST API for managing Braiins OS+ miners (35 stars, 18 releases)
- **Braiins OS Feeds** - Package feeds and build system (Makefile/Lua/Shell)
- **Official Documentation** - Braiins Academy guides and resources

**Official Resources:**
- [BOS+ API Repository](https://github.com/braiins/bos-plus-api)
- [Braiins OS Feeds Repository](https://github.com/braiins/braiins-os-feeds)
- [Braiins Academy](https://academy.braiins.com/en/braiins-os/about/)

## When to Use This Skill

Use this skill when you need to:
- Integrate with Braiins OS+ API for miner management
- Work with Braiins OS package feeds and build system
- Understand Braiins OS features and configuration
- Troubleshoot miner issues or check for known problems
- Review API changelog and release history
- Learn about Braiins OS from official documentation

## Quick Reference

### BOS+ API
- **Latest Version:** 1.8.0 (2025-11-25)
- **Stars:** 35
- **Open Issues:** 9
- **Last Updated:** 2025-12-02
- **Recent Releases:**
  - 1.8.0 (2025-11-25)
  - 1.7.0 (2025-08-10)
  - 1.6.0 (2025-06-10)

### Braiins OS Feeds
- **Stars:** 6
- **Primary Languages:** Makefile (40.0%), Lua (34.5%), Shell (25.6%)
- **Open Issues:** 2
- **Last Updated:** 2025-09-01

## Available References

### BOS+ API Documentation
- `references/bos-plus-api-README.md` - Complete API documentation
- `references/bos-plus-api-CHANGELOG.md` - Version history and changes (21KB)
- `references/bos-plus-api-releases.md` - 18 documented releases (14KB)
- `references/bos-plus-api-issues.md` - Recent GitHub issues
- `references/bos-plus-api-structure.md` - Repository structure

### Braiins OS Feeds
- `references/braiins-os-feeds-file_structure.md` - Repository structure
- `references/braiins-os-feeds-issues.md` - Recent GitHub issues

### Official Documentation
- `references/braiins-os-academy-index.md` - Documentation index
- `references/braiins-os-academy-other.md` - Additional resources

## Usage

### Working with the API

See `bos-plus-api-README.md` for:
- API endpoint documentation
- Authentication methods
- Request/response formats
- Code examples

### Build System & Feeds

See `braiins-os-feeds-file_structure.md` for:
- Package feed structure
- Build system architecture
- Makefile and Lua scripts

### Getting Started

1. Review the API README for integration basics
2. Check CHANGELOG for recent API changes
3. Consult release notes for version-specific features
4. Review known issues before implementation

## Notes

- **API Version:** Currently at v1.8.0 with active development
- **License:** None specified for both repositories
- **Rate Limits:** GitHub API rate limits encountered during scraping
- **Academy Limitation:** Braiins Academy uses JavaScript rendering (SPA), preventing automated content extraction
  - Manual addition of key Academy pages recommended (URLs provided by user)
  - Consider using browser automation for comprehensive Academy documentation
- **Additional Repositories:** Four additional Braiins OS repositories (bos-packages, bos-build, bos-assets, bos-plus-api-demos) could not be scraped due to GitHub API rate limits. These can be added later once the rate limit resets.

## Integration Status

✅ **Included Sources:**
1. braiins/bos-plus-api - API reference and documentation
2. braiins/braiins-os-feeds - Package feeds and build system
3. academy.braiins.com - Official documentation (limited content)

⏳ **Pending Sources (Rate Limited):**
1. braiins/bos-packages - Package definitions
2. braiins/bos-build - Build system
3. braiins/bos-assets - Assets and resources
4. braiins/bos-plus-api-demos - API usage examples

---

**Generated by Skill Seeker** | Comprehensive Multi-Source Scraper
**Last Updated:** 2025-12-28
**Total References:** 11 files (56KB+)