{"id":48540182,"url":"https://github.com/panoramicdata/panoramicdata.os","last_synced_at":"2026-04-08T04:01:52.930Z","repository":{"id":330852757,"uuid":"1121258500","full_name":"panoramicdata/PanoramicData.Os","owner":"panoramicdata","description":null,"archived":false,"fork":false,"pushed_at":"2025-12-29T14:36:12.000Z","size":194,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-31T02:46:13.447Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/panoramicdata.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-22T17:31:41.000Z","updated_at":"2025-12-29T14:36:16.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/panoramicdata/PanoramicData.Os","commit_stats":null,"previous_names":["panoramicdata/panoramicdata.os"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/panoramicdata/PanoramicData.Os","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/panoramicdata%2FPanoramicData.Os","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/panoramicdata%2FPanoramicData.Os/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/panoramicdata%2FPanoramicData.Os/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/panoramicdata%2FPanoramicData.Os/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/panoramicdata","download_url":"https://codeload.github.com/panoramicdata/PanoramicData.Os/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/panoramicdata%2FPanoramicData.Os/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31539229,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T16:28:08.000Z","status":"online","status_checked_at":"2026-04-08T02:00:06.127Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-08T04:01:52.217Z","updated_at":"2026-04-08T04:01:52.904Z","avatar_url":"https://github.com/panoramicdata.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PanoramicData.Os\n\n[![Build](https://github.com/panoramicdata/PanoramicData.Os/actions/workflows/build.yml/badge.svg)](https://github.com/panoramicdata/PanoramicData.Os/actions/workflows/build.yml)\n\nA custom operating system with a minimal Linux kernel and pure .NET 10 NativeAOT userspace, featuring a browser-based windowing system built on Chromium/CEF.\n\n## Features\n\n- **Minimal Linux Kernel**: Stripped-down kernel optimized for virtualization\n- **Pure .NET Userspace**: All userspace code written in C# using NativeAOT\n- **Browser-Based GUI**: Windows and applications rendered via Chromium Embedded Framework\n- **SSH Server**: Built-in SSH server for remote access\n- **Custom Shell**: Basic shell with command-line utilities\n\n## Quick Start\n\n### Prerequisites\n\n- Docker Desktop or Docker Engine\n- .NET 10 SDK (for development)\n- QEMU (for testing)\n\n### Building\n\n```bash\n# Linux/macOS\n./scripts/build.sh\n\n# Windows PowerShell\n.\\scripts\\build.ps1\n```\n\nThis will:\n1. Build the Docker build environment (first run only)\n2. Compile the .NET init process\n3. Build the Linux kernel\n4. Create the initramfs\n5. Output `vmlinuz` and `initramfs.cpio.gz` to the `output/` directory\n\n### Running\n\n```bash\n# Linux/macOS\n./scripts/run-qemu.sh\n\n# Windows PowerShell\n.\\scripts\\run-qemu.ps1\n\n# With graphics\n./scripts/run-qemu.sh --graphics\n.\\scripts\\run-qemu.ps1 -Graphics\n```\n\nPress `Ctrl+A, X` to exit QEMU.\n\n### SSH Access\n\nOnce the full system is running (Phase 3+), you can SSH in:\n\n```bash\nssh -p 2222 root@localhost\n```\n\n## Project Structure\n\n```\nPanoramicData.Os/\n├── configs/\n│   └── kernel.config       # Linux kernel configuration\n├── output/                  # Build output (gitignored)\n│   ├── vmlinuz             # Linux kernel\n│   └── initramfs.cpio.gz   # Initial RAM filesystem\n├── plans/                   # Implementation plans\n│   ├── MASTER_PLAN.md\n│   ├── Phase-001.md        # Foundation \u0026 Boot\n│   ├── Phase-002.md        # Network Stack\n│   └── ...\n├── scripts/\n│   ├── build.sh            # Build script (Linux/macOS)\n│   ├── build.ps1           # Build script (Windows)\n│   ├── run-qemu.sh         # QEMU runner (Linux/macOS)\n│   ├── run-qemu.ps1        # QEMU runner (Windows)\n│   ├── boot-test.exp       # Automated boot test\n│   └── ...\n├── src/\n│   └── PanoramicData.Os.Init/\n│       ├── Program.cs      # Init process entry point\n│       ├── Linux/          # Linux syscall bindings\n│       └── Logging/        # Serial console logging\n├── Dockerfile              # Build environment\n└── README.md\n```\n\n## Development\n\n### Kernel Configuration\n\nTo modify kernel configuration:\n\n```bash\ndocker run -it --rm \\\n    -v $(pwd):/workspace \\\n    panos-builder \\\n    kernel-menuconfig\n```\n\n### Adding New .NET Projects\n\nNew projects should be added under `src/` and follow the NativeAOT configuration pattern in `PanoramicData.Os.Init.csproj`.\n\n### Testing\n\nRun the automated boot test:\n\n```bash\n./scripts/boot-test.exp\n```\n\n## Roadmap\n\n- [x] Phase 1: Foundation \u0026 Boot\n- [ ] Phase 2: Network Stack\n- [ ] Phase 3: SSH Server\n- [ ] Phase 4: Graphics \u0026 Input\n- [ ] Phase 5: Chromium Integration\n- [ ] Phase 6: Window Manager\n- [ ] Phase 7: Built-in Apps\n- [ ] Phase 8: Multi-VM Support \u0026 Polish\n\nSee [plans/MASTER_PLAN.md](plans/MASTER_PLAN.md) for detailed implementation plans.\n\n## Target Platforms\n\n- QEMU (primary development target)\n- VirtualBox\n- Hyper-V\n- VMware\n\n## Requirements\n\n| Resource | Minimum | Recommended |\n|----------|---------|-------------|\n| RAM | 256 MB | 512 MB |\n| Disk | 128 MB | 256 MB |\n| CPUs | 1 | 2+ |\n\n## License\n\n[License TBD]\n\n## Contributing\n\n[Contribution guidelines TBD]\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpanoramicdata%2Fpanoramicdata.os","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpanoramicdata%2Fpanoramicdata.os","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpanoramicdata%2Fpanoramicdata.os/lists"}