Skip to content
View AegeanWorks's full-sized avatar
🎯
Focusing
🎯
Focusing

Highlights

  • Pro

Block or report AegeanWorks

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
AegeanWorks/README.md

AegeanWorks social preview

Website AIKit integrated Licensing Public repositories

We build software that thinks, remembers, and explains itself.


What we build

AegeanWorks is an independent studio building local-first AI systems, cognitive tooling, and computational research. The work favors small composable parts, inspectable state, and software that still works when the network does not.

Area What it means in practice
Cognitive systems Agent frameworks, tool routing, memory layers, and explicit belief control.
Governed autonomy Delivery gates, audit trails, and disruption recovery for AI coding agents.
Personal science N=1 experimentation, neuro-acoustics, and falsification-first research tooling.
Playable systems Simulations, puzzles, and games built to make complex mechanics legible.

Featured systems

A self-hosted, modular agent framework for persistent, tool-using autonomous systems. Workflows, long-term memory, RAG, and a plugin surface in one extensible runtime.

Crash-resilient governance and delivery gates for AI coding agents: versioned task ledger, commit-level verification, secret scanning, and per-project gates.

A local-first, privacy-focused platform for rigorous N-of-1 self-experimentation: apply scientific statistics to your own life data, on your own machine.

A mathematically precise neuro-acoustic desktop app for binaural, monaural, and isochronic tones, with hardware-aware safety limits.


Public project atlas

Every project repository below is public. Browse the full set on GitHub. The website's live atlas reads public repository titles, descriptions and topics from the GitHub API at page load; this snapshot remains the fallback for no-JavaScript readers and API failures. The portfolio toolbar filters by search, topic and archive status, keeps that view in the URL, and can reveal every topic in the catalogue from a bounded, scrollable topic shelf. Each portfolio card carries the repository's own logo, and opens a local dossier with its social preview, metadata, commit-stamped screenshots when media exists, and a README excerpt. Captures open in an in-page viewer with previous/next, captions and commit provenance, while the repository link remains one click away. Browser apps and games also appear on the Live page with their version and commit; Prism-Relay, Weft, Iris, Tessera, Meridian and Palette run in the page. Palette is the local-first image editor with layers, blend modes, clipping masks, layer transforms, gradients, selections, clipboard, layer-via-copy/cut, flatten, crop ratios, canvas size, histogram/auto levels, local autosave recovery, drawing tools, clone stamp, dodge/burn, adjustments, filters and scaled PNG/JPEG/WebP export; images never leave the browser. The Editor page still offers a full-window Palette session.

Cognitive AI & Agent Infrastructure
Project Description
ModelDuck A local GGUF chat studio: load a model, talk to it, and serve an OpenAI-compatible API. Runs on the CPU or a Vulkan GPU; no cloud account, no telemetry. Chats, prompts and settings stay on your computer; the only network requests are model downloads you start (the inference runtime is never downloaded or built on demand).
Cairn An agent-first systems language with its own x86-64 backend. Cairn compiles straight to a Windows PE executable: no C compiler, no assembler, no linker, no libc, no runtime library.
NeuroCore A self-hosted, modular AI agent framework for persistent, tool-using autonomous systems: workflows, long-term memory, RAG and a plugin architecture in one platform. Free personal use under AL-1.1; commercial use under ACL-1.0.
AIKit Crash-resilient governance and delivery gates for AI coding agents: versioned task ledger, commit-level verification, secret scanning and per-project gates. Free for personal use under AL-1.1; commercial use under ACL-1.0.
Lacon An AI that thinks in as few letters as possible, recursively over a long context: its own alphabet, budget, thinker and recursive engine. No network, no API key, no model weights; the core is standard library only. Free personal use under AL-1.1; commercial use under ACL-1.0.
Lattice A provenance-first research knowledge graph for humans and AI agents. Local-first, SQLite-backed and standard library only. Free personal use under AL-1.1; commercial use under ACL-1.0.
Assay Tamper-evident audit evidence for AI agents: a local-first hash-chained ledger, policy review, and offline-verifiable evidence packs. Free personal use under AL-1.1; commercial use under ACL-1.0.
Aegean-Licensing The Aegean License family (AL, AGL and ASL 1.1) and the Aegean Commercial License: canonical texts, policies, commercial templates and certificate verification tooling for AegeanWorks projects.
ChatDuck A fast, local-first web chat UI for any OpenAI-compatible model server, including ModelDuck. It is one static page and a few modules: no build step, no framework, no backend, and no telemetry.
Research & Simulation
Project Description
N1-Engine A local-first, privacy-focused platform for rigorous N-of-1 self-experimentation: apply scientific statistics to your own life data, on your own machine. Free personal use under AL-1.1; commercial use under ACL-1.0.
Fluid-Universe Falsification-first research codebase testing a Z3 circulant origin of the Koide lepton relation, with a separately labelled nematic-fluid UV speculation. Free non-commercial research under ASL-1.1; commercial use under ACL-1.0.
PNN Oral, blood-brain barrier-penetrant agents that soften hypothalamic perineuronal nets to restore insulin signaling in obesity: research notes, data and computational analyses. Free non-commercial research under ASL-1.1; commercial use under ACL-1.0.
Primordia A zero-dependency evolution sandbox: seed a biosphere, run its clock, and watch genomes vary, compete and speciate. Every run replays exactly from its seed, and a fossil record keeps its history. Free personal use under AL-1.1; commercial use under ACL-1.0.
Orrery An N-body gravitational sandbox for the terminal or the browser: nine curated worlds, a symplectic integrator, optional relativity and collisions, live energy diagnostics, orbit trails and CSV/JSON export. Standard library only. Free non-commercial research under ASL-1.1; commercial use under ACL-1.0.
Research-Engine A falsification-first research engine that turns questions into provenance-backed claims, executable kill tests, and auditable verdicts.
NeurologyClinicTemplates-TR Standardized Turkish anamnesis (patient history) templates for common neurology complaints, helping neurologists, residents and medical students document assessments completely and systematically. Free personal use under AL-1.1; commercial use under ACL-1.0.
Atlas An interactive visual knowledge platform for scientific figures.
Health, Neuro & Personal Tools
Project Description
NeuralBeat A local-first neuro-acoustic desktop app that generates mathematically accurate binaural, monaural and isochronic tones for focus, meditation, relaxation and sleep. Free personal use under AL-1.1; commercial use under ACL-1.0.
NeuroOptic A research-grade visual oscillator for brainwave entrainment: configurable 1-120 Hz frequencies, hardware-aware safety limits and drift-free phase accumulation. Free personal use under AL-1.1; commercial use under ACL-1.0.
NeuralDeck An offline desktop app that turns PDFs, Word files and other documents into high-quality Anki flashcards with a local LLM, with smart deck matching, AI editing and direct Anki sync. Free personal use under AL-1.1; commercial use under ACL-1.0.
NobetWizard An automated duty roster generator built with Streamlit: fair monthly schedules under constraints such as gender, rest days and availability, with Excel and PDF export, in English and Turkish. Free personal use under AL-1.1; commercial use under ACL-1.0.
Mnemo A dependency-free, local-first spaced-repetition flashcard CLI: study each card on the day the SM-2 algorithm says it is due, and keep everything in one readable JSON file on your machine. Free personal use under AL-1.1; commercial use under ACL-1.0.
Meridian A zero-dependency time zone meeting planner that runs entirely in the browser: add people and cities, compare every local hour side by side, find the overlap that works for everyone, then share it as a link or a calendar file.
Palette A local-first, zero-dependency image editor for the browser: layers, blend modes, selections, gradients, filters, autosave recovery and PNG/JPEG/WebP export.
Afterimage A visual perception gauntlet with a daily challenge: one tile in every grid is a shade, a size, or an angle off. Installable, offline-capable PWA.
NoMoreClutter An AI desktop app that organizes your files with large language models: it analyzes, categorizes and renames them with descriptive names, and works with local LLMs. Free personal use under AL-1.1; commercial use under ACL-1.0.
Developer Tools & Utilities
Project Description
Tessera A seamless pattern studio: compose geometric tiles in the browser and export crisp SVG.
Pocket-Planner A local-first task manager for capturing, prioritizing, and completing work from a fast terminal workflow.
Dupefinder Read-only duplicate file finder that groups byte-identical files by size and SHA-256 and reports reclaimable space.
Driftwood Offline CLI that ranks code hotspots by combining git churn history with file complexity, so maintainers know where refactoring pays off.
Chronos A lightweight, local-first focus and session orchestrator for developers: track deep-work sessions, micro-milestones and interruptions, and get productivity insights. Python standard library only. Free personal use under AL-1.1; commercial use under ACL-1.0.
Gauge A zero-dependency terminal ruler for numeric series: read numbers from arguments, a file or a pipe and draw a sparkline, signed bars, a histogram, a box plot or a statistics block. stats --json feeds other tools. Free personal use under AL-1.1; commercial use under ACL-1.0.
Tally A dependency-free, local-first expense ledger for the terminal: record what you spend, list it and see where the money went, all in one readable JSON file on your machine. Free personal use under AL-1.1; commercial use under ACL-1.0.
Tempo A focus timer you run on your own machine: one Python process, a browser page, no dependencies, no account and no network calls. Focus and break phases alternate, and every fourth break is a long one. Free personal use under AL-1.1; commercial use under ACL-1.0.
Pebble A tiny, dependency-free scripting language: lexer, parser, tree-walking evaluator and REPL. Built as an AIKit evaluation project, where the process is under test as much as the code. Free personal use under AL-1.1; commercial use under ACL-1.0.
Photo-Harbor A self-hosted photo server for Windows: an iPhone sends new photos over home Wi-Fi through Apple Shortcuts, with no app to install, verified-hash cleanup and a gallery. Free personal use under AL-1.1; commercial use under ACL-1.0.
Muse Prompt-driven AI music creation with an automated listener that scores how well each track fits its theme, available as a CLI and a Python library. Free personal use under AL-1.1; commercial use under ACL-1.0.
UI-Sandbox A small React + Vite surface for exercising AIKit's bounded UI guard: one screen, token-driven theming, and a labelled control for every interaction. Free personal use under AL-1.1; commercial use under ACL-1.0.
Aegean-Reforge Archived: Aegean Reforge is integrated into AegeanWorks/AIKit. Progressive, evidence-backed Git history auditing and safe repair now ships as reforge/ plus reforge.py.
Games & Playable Experiments
Project Description
Weft A zero-dependency thread-routing puzzle: draw glowing threads between matching spools, fill every cell of the loom, and restore the tapestry across twenty-four chambers, with a fresh 7x7 daily weave. Static HTML/CSS/ES modules for any static host.
Iris A neon color-mixing puzzle: route red, green and blue beams through rotating mirrors and dye cells, blend exact hues, and light every receiver across three episodes.
Dustline Dustline: Survivors is a top-down horde-survival shooter with endless procedural arenas, auto-firing weapons, 7 maps, 18 mob types, rotating bosses plus megas, Boss Rush mode and extraction banking.
Aldervale A 2.5D medieval RPG drawn in tiny ASCII cells: low-poly 3D models baked into shaded sprites, voxel terrain, fog, day and night, water, quests, combat, loot, shops and saves. Python standard library only: no dependencies, no assets, no build step. Free personal play under AGL-1.1; commercial use under ACL-1.0.
MemoryReconstruction A top-down action roguelike about rebuilding a shattered world from lost memories: expeditions from the Sanctuary through sixteen procedurally generated sections, built with TypeScript and PixiJS. Free personal play under AGL-1.1; commercial use under ACL-1.0.
Crypt-Crawler A tactical turn-based dungeon crawler for the browser: procedural levels, inventory, combat and headless browser inspection. Free personal play under AGL-1.1; commercial use under ACL-1.0.
Cyberpulse A retro-cyberpunk terminal hacking game built on behavioral psychology: procedural puzzle nodes, ICE defenses, push-your-luck extraction, persistent progression and a five-act campaign. Python standard library only. Free personal play under AGL-1.1; commercial use under ACL-1.0.
Fold A 4x4 tile-merge puzzle you run on your own machine: one Python process, a browser page, no dependencies, no account and no network calls. Slide, merge and chase 2048; the server owns the rules and the browser only renders. Free personal play under AGL-1.1; commercial use under ACL-1.0.
Prism-Relay A neon light-routing puzzle game: rotate mirrors and splitters, fold beams through portals, and charge every receiver across three episodes. Free personal play under AGL-1.1; commercial use under ACL-1.0.
Voidfarer A zero-dependency space flight and exploration simulator with an autonomous deep-space fleet, a procedural galaxy and a Windows cockpit: route reactor power, board derelicts, scoop fuel, command drones, fight and trade. Free personal play under AGL-1.1; commercial use under ACL-1.0.
Keystone A small, game-agnostic 3D engine core in Python: OpenGL 3.3 rendering, textured materials, scene graph, meshes and OBJ loading, fixed-step loop, action input, collision primitives, deterministic replay, atomic serialization, and a human HUD/help overlay rendered with an embedded bitmap font.

Research threads

  • Obesity and incretin regulation β€” GLP-1 signaling, hypothalamic circuitry, and falsifiable mechanistic models.
  • Memory integrity β€” how agents store, revise, and falsify beliefs without drifting.
  • Neuro-acoustics β€” precise entrainment, perceptual safety, and measurable outcomes.
  • Computational cosmology β€” lepton mass relations and fluid analogies, kept clearly separated from speculation.
  • Consciousness engineering β€” architecture questions treated as engineering constraints, not decoration.

Philosophy

Local-first over API dependency.
Modular over monolithic.
Structured cognition over prompt chaos.
Falsification over confident prose.


Toolbox

Python FastAPI Streamlit SQLite JavaScript Git


🎨 Brand Assets

AI-Generated Brand Artwork. The banner and logo are AI-generated brand assets. They are illustrative and may not literally depict every feature or the full project scope.

License

AegeanWorks publishes source-available and open-source projects. AL-1.1 for software, AGL-1.1 for games, ASL-1.1 for research, and the Aegean Commercial License 1.0 (ACL-1.0) for commercial use; see COMMERCIAL.md. The browser app builds under docs/live/ keep their own license: AL-1.1 for apps and AGL-1.1 for games. The vendored Palette build under docs/editor/ is AL-1.1 for personal use and ACL-1.0 for commercial use. Some repositories keep GNU AGPL-3.0, Apache-2.0 or MIT, and each repository's LICENSE governs. Versions published under GNU AGPL-3.0 keep that grant, including its commercial permissions. The canonical texts and tier table live in the license catalog. A commercial certificate can be checked against the public register at aegeanworks.github.io/AegeanWorks/verify.html.


Connect

Built in public, one inspectable system at a time.


Cold-Start Quick Reference

  • Runtime Prerequisites: Git 2.30+, Python 3.10+ (standard library only), and Node 20+ for the browser-verifier and live-atlas parity gates.

Canonical Regression Shield Gate:

python -m unittest discover -s tests

Browser-Verifier Parity Gate:

node tests/verify/run-tests.mjs

Live-Atlas Parity Gate:

node tests/atlas/run-tests.mjs

Project-Page Parity Gate:

node tests/project/run-tests.mjs

All five suites run in GitHub Actions on every push and pull request (.github/workflows/tests.yml). The Node suites pin the browser verifier, the live GitHub atlas, the README renderer and the live catalog to the same rules as the Python code. A scheduled media.yml run pulls logos, social previews and repository captures, regenerates the manifests and commits them when a repository changed. A scheduled live.yml run copies the browser app builds, enforces their static contract, and records their versions and commits.

What's Inside

AegeanWorks/
β”œβ”€β”€ README.md                <- Profile and public project atlas
β”œβ”€β”€ LICENSE                  <- Aegean License 1.1 (AL-1.1): free personal use
β”œβ”€β”€ COMMERCIAL.md            <- Licensing tiers and ACL-1.0 commercial terms
β”œβ”€β”€ LICENSES/                <- Pinned license text for REUSE metadata
β”‚   β”œβ”€β”€ LicenseRef-AL-1.1.txt
β”‚   └── LicenseRef-AGL-1.1.txt <- Live app and game builds
β”œβ”€β”€ REUSE.toml               <- REUSE aggregate license annotations
β”œβ”€β”€ .gitignore               <- Git and AIKit transient-state exclusions
β”œβ”€β”€ .gitattributes           <- Byte-stable checkouts for hashed browser builds
β”œβ”€β”€ package.json             <- Node module marker for the browser-core parity suites
β”œβ”€β”€ assets/
β”œβ”€β”€ docs/                    <- Static GitHub Pages site and its assets
β”‚   β”œβ”€β”€ .nojekyll            <- Serve files exactly as committed
β”‚   β”œβ”€β”€ 404.html             <- Branded not-found page
β”‚   β”œβ”€β”€ index.html           <- Studio profile and public project atlas
β”‚   β”œβ”€β”€ project.html         <- Local project dossier (metadata and README excerpt)
β”‚   β”œβ”€β”€ project-core.js      <- Pure README block and repository lookup rules
β”‚   β”œβ”€β”€ project.js           <- Dossier fetch and safe text rendering
β”‚   β”œβ”€β”€ lightbox-core.js     <- Pure viewer index and counter rules
β”‚   β”œβ”€β”€ lightbox.js          <- Dialog viewer: navigation, focus and metadata
β”‚   β”œβ”€β”€ live.html            <- Redirect to the play.html address
β”‚   β”œβ”€β”€ live-core.js         <- Pure manifest, lookup and version-label rules
β”‚   β”œβ”€β”€ live.js              <- Catalog rendering, player and URL state
β”‚   β”œβ”€β”€ live-home.js         <- Homepage live app cards
β”‚   β”œβ”€β”€ live.json            <- Synced app versions, commits and digests
β”‚   β”œβ”€β”€ play.html            <- Live app catalog and fullscreen player
β”‚   β”œβ”€β”€ live/                <- Versioned builds, screenshots and slider data
β”‚   β”œβ”€β”€ editor.html          <- Palette image editor workbench
β”‚   β”œβ”€β”€ editor/              <- Vendored Palette build and content-hash manifest
β”‚   β”œβ”€β”€ media/               <- Dossier logos, social previews and screenshots
β”‚   β”œβ”€β”€ atlas-snapshot.json  <- Static fallback for the atlas and dossiers
β”‚   β”œβ”€β”€ verify.html          <- Public certificate verifier (certificate stays local)
β”‚   β”œβ”€β”€ verify-core.js       <- Shared format-2 canonicalization and checks
β”‚   β”œβ”€β”€ verify.js            <- Browser UI and canonical register fetch
β”‚   β”œβ”€β”€ atlas-core.js        <- Pure live-atlas validation, inference and sync planning
β”‚   β”œβ”€β”€ atlas.js             <- GitHub API fetch, cache and DOM reconciliation
β”‚   β”œβ”€β”€ app.js               <- Navigation, filtering, reveal and service-worker registration
β”‚   β”œβ”€β”€ sw-client.js         <- Shell update check, reload and stale-cache recovery
β”‚   β”œβ”€β”€ sw.js                <- Cached shell, offline fallback and API cache
β”‚   β”œβ”€β”€ offline.html         <- Branded offline page
β”‚   β”œβ”€β”€ styles.css           <- Zero-dependency design system
β”‚   β”œβ”€β”€ favicon.svg          <- Site mark
β”‚   β”œβ”€β”€ icon-192.png         <- Install icon
β”‚   β”œβ”€β”€ icon-512.png         <- Install icon
β”‚   β”œβ”€β”€ apple-touch-icon.png <- iOS home-screen icon
β”‚   β”œβ”€β”€ og.png               <- Social card
β”‚   β”œβ”€β”€ robots.txt           <- Crawler rules
β”‚   β”œβ”€β”€ sitemap.xml          <- Indexed pages
β”‚   β”œβ”€β”€ security.html        <- Security model and disclosure
β”‚   β”œβ”€β”€ privacy.html         <- Data handling and third-party requests
β”‚   β”œβ”€β”€ accessibility.html   <- WCAG commitment, limits and feedback
β”‚   β”œβ”€β”€ .well-known/
β”‚   β”‚   └── security.txt     <- RFC 9116 disclosure metadata
β”‚   └── site.webmanifest     <- Web app manifest
β”œβ”€β”€ .github/
β”‚   β”œβ”€β”€ FUNDING.yml          <- Sponsorship configuration
β”‚   └── workflows/
β”‚       β”œβ”€β”€ tests.yml        <- CI regression gate on every push
β”‚       β”œβ”€β”€ media.yml        <- Weekly refresh of logos, previews and captures
β”‚       └── live.yml    <- Weekly refresh of the browser app builds
β”œβ”€β”€ .aikit/
β”‚   β”œβ”€β”€ project.json         <- Project identity and test command
β”‚   β”œβ”€β”€ media.json           <- Reviewed brand media state and approvals
β”‚   β”œβ”€β”€ guidelines.md        <- Project-only rules
β”‚   β”œβ”€β”€ decisions.md         <- ADR register
β”‚   β”œβ”€β”€ codebase_map.md      <- Generated AST symbol catalog
β”‚   β”œβ”€β”€ task_ledger.json     <- Delivery ledger
β”‚   └── reforge.json         <- Progressive audit run state and applied findings
β”œβ”€β”€ tools/
β”‚   β”œβ”€β”€ build_dossier_media.py  <- Fetches, optimizes and verifies dossier media
β”‚   β”œβ”€β”€ sync_editor.py     <- Copies and verifies the Palette editor build
β”‚   β”œβ”€β”€ sync_live_apps.py  <- Copies and verifies the browser app builds
β”‚   └── social/            <- Studio X manager: gates, media pipeline, browser publish
└── tests/
    β”œβ”€β”€ test_profile.py      <- Content, metadata and link integrity tests
    β”œβ”€β”€ test_social_manager.py <- Social gates: topic, evidence, media, spam, approval
    β”œβ”€β”€ test_social_browser.py <- Browser publish: package, compose-only, armed click
    β”œβ”€β”€ test_social_review.py <- Aesthetic review: distortion, size, sharpness blocks
    β”œβ”€β”€ test_sync_live_digest.py <- Live build digest and retention tests
    β”œβ”€β”€ test_sync_editor_digest.py <- Editor line-ending and binary digest tests
    β”œβ”€β”€ live/
    β”‚   └── run-tests.mjs     <- Live catalog and version-label parity
    β”œβ”€β”€ metadata/
    β”‚   └── repositories.json <- GitHub title, topic and description snapshot
    β”œβ”€β”€ vectors/
    β”‚   └── verification-vector.json <- Known-answer certificate fixture
    β”œβ”€β”€ verify/
    β”‚   └── run-tests.mjs    <- Browser-verifier parity suite
    β”œβ”€β”€ atlas/
    β”‚   └── run-tests.mjs    <- Live GitHub atlas parity suite
    └── project/
        └── run-tests.mjs    <- README-rendering parity suite

Screenshots

AegeanWorks home at 2026-11-03

AegeanWorks live catalog at 2026-11-03

commit ea26791 Β· 2026-11-03 Β· viewport 1440x900 Β· home plus live catalog

Pinned Loading

  1. NeuralBeat NeuralBeat Public

    A local-first neuro-acoustic desktop app that generates mathematically accurate binaural, monaural and isochronic tones for focus, meditation, relaxation and sleep. Free personal use under AL-1.1; …

    Python 37 2

  2. NeuralDeck NeuralDeck Public

    An offline desktop app that turns PDFs, Word files and other documents into high-quality Anki flashcards with a local LLM, with smart deck matching, AI editing and direct Anki sync. Free personal u…

    Python 12 1

  3. NeuroCore NeuroCore Public

    A self-hosted, modular AI agent framework for persistent, tool-using autonomous systems: workflows, long-term memory, RAG and a plugin architecture in one platform. Free personal use under AL-1.1; …

    Python 8 1

  4. AIKit AIKit Public

    Crash-resilient governance and delivery gates for AI coding agents: versioned task ledger, commit-level verification, secret scanning and per-project gates. Free for personal use under AL-1.1; comm…

    Python 5

  5. Aegean-Licensing Aegean-Licensing Public

    The Aegean License family (AL, AGL and ASL 1.1) and the Aegean Commercial License: canonical texts, policies, commercial templates and certificate verification tooling for AegeanWorks projects.

    Python 1

  6. Voidfarer Voidfarer Public

    A zero-dependency space flight and exploration simulator with an autonomous deep-space fleet, a procedural galaxy and a Windows cockpit: route reactor power, board derelicts, scoop fuel, command dr…

    Python 1