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

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. Markdown is supported. 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 — local-first AI, cognitive systems and computational research

Website AIKit integrated Licensing Public repositories

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


What we build

AegeanWorks is an independent software studio working on local-first AI systems, cognitive architecture, 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 platform for rigorous personal N=1 experimentation — protocol logging, metabolic tracking, and hormonal optimization models.

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.

Cognitive AI & Agent Infrastructure
Project Description
NeuroCore Modular agent framework with workflows, memory, RAG, and plugins.
AIKit Governance, delivery gates, and recovery for AI coding agents.
lacon An AI that thinks in as few letters as possible, recursively.
lattice Provenance-first knowledge graph for humans and agents.
assay Tamper-evident audit evidence with hash-chained ledgers.
aegean-licensing Dual-licensing framework and certificate verification tooling.
Research & Simulation
Project Description
N1-Engine Local-first, privacy-focused N=1 experimentation platform.
fluid-universe Falsification-first code testing a Z3 origin of the Koide relation.
PNN Perineuronal-net softening and insulin signaling in obesity.
primordia Zero-dependency evolution sandbox with exact seed replay.
orrery Terminal N-body gravitational sandbox with live diagnostics.
NeurologyClinicTemplates-TR Standardized Turkish neurology anamnesis templates.
Health, Neuro & Personal Tools
Project Description
NeuralBeat Binaural, monaural, and isochronic tone generator.
NeuroOptic Research-grade visual oscillator for brainwave entrainment.
NeuralDeck Offline document-to-flashcard desktop app powered by local AI.
NobetWizard Fair, exportable duty-roster optimizer built with Streamlit.
mnemo Dependency-free spaced-repetition flashcard CLI.
NoMoreClutter AI-powered desktop file organizer.
Developer Tools & Utilities
Project Description
chronos Local-first focus and session orchestrator.
gauge Zero-dependency terminal ruler for numeric series.
tally Dependency-free expense ledger for the terminal.
tempo Local focus timer with no account and no network calls.
pebble Tiny dependency-free scripting language, built as an AIKit evaluation.
photo-harbor Self-hosted Windows photo server for iPhone Shortcuts.
muse Prompt-driven AI music creation with automated listening scores.
ui-sandbox Small React + Vite surface for exercising AIKit's UI guard.
Games & Playable Experiments
Project Description
aldervale 2.5D medieval RPG rendered in tiny ASCII cells.
MemoryReconstruction Action-roguelike metroidvania about rebuilding a lost world.
crypt-crawler Tactical turn-based web dungeon crawler.
cyberpulse Retro-cyberpunk terminal hacking simulation.
fold Local 4x4 tile-merge game with no dependencies or accounts.
prism-relay Neon light-routing puzzle with mirrors, prisms, and receivers.
voidfarer Autonomous deep-space fleet and procedural galaxy simulator.

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


License

Current releases are free for personal use under a license per domain: AL-1.1 for software, AGL-1.1 for games, and ASL-1.1 for research. Commercial use of those releases needs the Aegean Commercial License 1.0 (ACL-1.0); see COMMERCIAL.md. Versions already published under GNU AGPL-3.0 keep that grant, including its commercial permissions. The canonical texts and tier table live in the license catalog.


Connect

Built in public, one inspectable system at a time.


Cold-Start Quick Reference

  • Runtime Prerequisites: Git 2.30+ and Python 3.10+ (standard library only).

Canonical Regression Shield Gate:

python -m unittest discover -s tests

The same suite runs in GitHub Actions on every push and pull request (.github/workflows/tests.yml).

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
├── .gitignore               <- Git and AIKit transient-state exclusions
├── assets/
│   └── banner.svg           <- Profile banner
├── docs/                    <- Static GitHub Pages site and its assets
├── .github/
│   ├── FUNDING.yml          <- Sponsorship configuration
│   └── workflows/
│       └── tests.yml        <- CI regression gate on every push
├── .aikit/
│   ├── project.json         <- Project identity and test command
│   ├── guidelines.md        <- Project-only rules
│   ├── decisions.md         <- ADR register
│   ├── codebase_map.md      <- Generated AST symbol catalog
│   └── task_ledger.json     <- Delivery ledger
└── tests/
    └── test_profile.py      <- Content and link integrity tests

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 33 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 10 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