Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 26 additions & 0 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
name: CPU checks
on:
push:
pull_request:
permissions:
contents: read
jobs:
cpu:
runs-on: ubuntu-24.04
steps:
- uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
with:
persist-credentials: false
- uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
with:
python-version: '3.12'
- name: Install pinned Rust toolchain
run: rustup toolchain install --profile minimal "$(python -c 'import tomllib; print(tomllib.load(open("rust-toolchain.toml", "rb"))["toolchain"]["channel"])')"
- name: Runtime tests without model weights
run: cargo test --locked --no-default-features
- name: Launcher and model client tests
run: cargo test --manifest-path distribution/launcher/Cargo.toml --locked --features model-plugin-client
- name: Packaging contracts
run: python -m unittest discover -s distribution/release -p 'test_*.py' -v
- name: Maintained documentation links
run: python scripts/validation/docs.py
7 changes: 7 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -18,3 +18,10 @@ __pycache__/
/distribution/launcher/target/
/distribution/out/
/.release-validation-tmp/

# Local credentials and source-package build output.
.env
.env.*
!.env.example
/distribution/vllm/build/
/distribution/vllm/*.egg-info/
13 changes: 11 additions & 2 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Qwen memory integration ownership
# Aimee Native integration ownership

Use this repository for all Qwen/Aimee memory integration code, experiments,
Use `RakuenSoftware/aimee-native` for all model/Aimee memory integration code, experiments,
tests, design notes, validation reports, and associated evidence. Do not add
those files back to the sibling `aimee` repository.

Expand All @@ -21,3 +21,12 @@ credentials, private signing keys, model weights, or private production memory.

Use the documented test commands. Research fixture grants do not establish
production authorization integration. Keep that distinction in results.

Current source licensing is AGPL-3.0-only. Preserve third-party notices and
archived release metadata. New binary releases must include the license and
corresponding source for the exact build. See `docs/public-release.md`.

For current enrolled serving, start with `docs/aimee-compatibility.md` and
`dependencies/aimee-release.json`. The Go research tools consume the separate
historical source pin through `scripts/prepare-research-dependency.py`; do not
point them at the current Aimee release or recreate retired core policy APIs.
20 changes: 20 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# Contributing to Aimee Native

Start with [README.md](README.md), [AGENTS.md](AGENTS.md) and
[public release preparation](docs/public-release.md). Source contributions are
licensed under AGPL-3.0-only. Keep third-party notices and dataset provenance.

Use the build and test commands in the README and
[Rust runtime guide](docs/rust-runtime.md). CPU CI exercises the Rust runtime,
launcher and Python packaging contracts without model weights. Go tests require
the separate Aimee source dependency. GPU and enrolled-service checks require
the matching documented environment; report skipped checks explicitly.

Keep authoritative storage and policy in Aimee. Research fixture approvals do
not establish production authorization. Never contribute credentials, private
keys, production memory or model weights.

Preserve archived evidence, source hashes and historical runtime paths. Explain
corrections in a new report. Include the relevant tests and supported hardware
scope with a pull request; avoid treating earlier GPU results as certification
of changed binaries.
2 changes: 1 addition & 1 deletion Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

12 changes: 10 additions & 2 deletions Cargo.toml
Original file line number Diff line number Diff line change
@@ -1,11 +1,19 @@
[package]
name = "aimee-qwen"
name = "aimee-native"
version = "0.1.0"
edition = "2024"
publish = false
license = "LicenseRef-Proprietary"
description = "Native memory integration for Aimee-supported model runtimes"
repository = "https://github.com/RakuenSoftware/aimee-native"
license = "AGPL-3.0-only"

[features]
# Dedicated model wheels select one adapter; unbound development exposes all.
adapter-gemma4-12b = []
adapter-gemma4-26b = []
adapter-qwen3-8-27b = []
adapter-gemma4-e2b = []
adapter-gemma4-e4b = []
default = ["torch"]
torch = ["dep:tch"]
# Client build excludes offline authoring entry points and research diagnostics.
Expand Down
46 changes: 46 additions & 0 deletions DATASETS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
# Reference data and archived research

The AGPL license covers Aimee Native source. It does not replace upstream data,
model or third-party code terms. No foundation-model weights are distributed by
the current release. Download weights independently under their publisher's terms.

## Public reference snapshots

The [v1 inventory](knowledge/general-v1/README.md) and
[v2 inventory](knowledge/general-v2/README.md) record transformations, fields,
retrieval times, exact input hashes and experimental limitations. Retain their
provenance and this attribution when redistributing derived reference corpora.

| Source | Attribution and terms | Changes here |
| --- | --- | --- |
| GeoNames | Credit [GeoNames](https://www.geonames.org/), [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); [source information](https://www.geonames.org/export/) | Cities500 snapshot projected into canonical records and alternate cues; original dump/readme preserved. |
| IANA service registry | [IANA protocol registries, CC0](https://www.iana.org/help/licensing-terms) | Service names, ports and transports consolidated; raw public registry snapshot also retained. |
| World Bank country API | Credit World Bank, adapted country/economy data; [data terms](https://data.worldbank.org/summary-terms-of-use), default CC BY 4.0 subject to stated exceptions and additional terms | Aggregate regions excluded; economy identifiers and classifications retained. No third-party indicator series imported. |
| NASA Exoplanet Archive | Operated by Caltech under NASA's Exoplanet Exploration Program; [acknowledgment and citation guidance](https://exoplanetarchive.ipac.caltech.edu/docs/acknowledge.html) | Public composite-parameter TAP rows projected into factual records; no paper full texts or images. Preserve per-record provenance and cite the Archive when using these data. |
| NIST CODATA 2022 | Tiesinga, Mohr, Newell and Taylor, NIST, [database version 9.0](https://physics.nist.gov/cuu/Reference/versioncon.shtml); [NIST use terms](https://www.nist.gov/copyrights-disclaimers) | Complete public ASCII table projected into quantities, units and uncertainties; optional normalization is a separately identified experiment. No endorsement by NIST is implied. |

NIST's general permission applies to information not marked as copyrighted;
its separate [SRD policy](https://www.nist.gov/open/copyright-fair-use-and-licensing-statements-srd-data-software-and-technical-series-publications)
distinguishes protected Standard Reference Data. The retained constants input
has no separate copyright marking. These notices do not assert that all SRD is
public domain or relicense upstream databases under AGPL.

These are historical factual snapshots, not a live or certified reference
service. They carry their upstream limitations and no project warranty. Public
data possession does not authorize access to private Aimee memory.

## Historical evidence and dependency snapshots

Research reports retain original bytes, runtime paths and hashes. Archived
candidate wheels may retain their original proprietary metadata; they are
historical evidence, not the AGPL release wheels. New release manifests identify
the supported artifacts explicitly. Historical tensor fixtures are experiment
outputs, not foundation-model checkpoints.

The separately owned Aimee source snapshot is documented in
[its provenance record](dependencies/aimee-memory-source-2026-09-21.json).
Its base revision `912207eecb9c010e738ae7e36678eeae34ba2d73` is AGPL-3.0-only;
the [AGPL text](LICENSE) accompanies this repository. The original archive lacks
a license member and remains unchanged to preserve its recorded hash. Current
enrolled serving depends on the released Aimee API rather than this research
snapshot. Dependency code is not relicensed by these notices.
Loading
Loading