https://github.com/zairbulos/byte-history
Daily tech milestones generated by AI and served through a REST API
https://github.com/zairbulos/byte-history
artificial-intelligence efemerides milestones
Last synced: 15 days ago
JSON representation
Daily tech milestones generated by AI and served through a REST API
- Host: GitHub
- URL: https://github.com/zairbulos/byte-history
- Owner: ZairBulos
- License: mit
- Created: 2025-07-02T22:09:42.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-08-09T21:53:39.000Z (2 months ago)
- Last Synced: 2025-08-09T23:29:30.291Z (about 2 months ago)
- Topics: artificial-intelligence, efemerides, milestones
- Homepage: https://byte-history-site.vercel.app/
- Size: 195 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Byte History
**Byte History** is an autonomous platform that generates and publishes a daily programming or technology milestone using artificial intelligence.
## Overview
This repository serves as the monorepo and integration point for the Byte History platform, orchestrating the following components as submodules:
- **Worker**: Generates a new milestone daily using Gemini (Google Generative AI) and stores it in a PostgreSQL database.
- **API**: Exposes the latest milestone through a REST API, with caching, access control, and OpenAPI documentation.
- **Website**: Minimalist web interface that displays the daily milestone to end users.
## Architecture
```text
┌────────────┐ 1. GitHub Actions (cron)
│ Worker │ ──────────────────────────────┐
└────────────┘ │
│ │
▼ │
┌──────────────┐ 2. Store milestone ◄────┘
│ PostgreSQL │◄────────────────────────────┐
└──────────────┘ │
│ │
▼ │
┌────────────┐ 3. API exposes milestone │
│ API │───────────────────────────────┘
└────────────┘
│
▼
┌────────────┐
│ Web │
└────────────┘
```
**Flow**:
1. The **Worker** runs daily (00:00 ART) via GitHub Actions and generates a milestone using Gemini.
2. The milestone is stored in the PostgreSQL database (Supabase).
3. The **API** exposes the latest milestone via `/api/tech-milestones`, with caching and rate limiting.
4. The **Website** consumes the API and displays the milestone to users.
## Deployment
| Component | Platform |
| ------------------------------------------------------------------------------------- | --------------------- |
| [API](https://diverse-gilberta-zairbulos-952039d2.koyeb.app/swagger-ui/index.html) | Koyeb |
| [Website](https://byte-history-site.vercel.app/) | Vercel |
| [Worker](https://github.com/ZairBulos/byte-history-worker/actions/workflows/main.yml) | GitHub Actions (cron) |
## Getting Stated
To work with all components, clone this repository with submodules:
```sh
git clone --recurse-submodules https://github.com/ZairBulos/byte-history.git
```
For setup and development instructions, see the README in each submodule.
## License
This project is licensed under the [MIT License](./LICENSE).