Skip to content
Closed
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
45 changes: 45 additions & 0 deletions .zenodo.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
{
"title": "Trinity: Ternary Vector Symbolic Architecture Framework",
"description": "Trinity is a ternary computing framework implementing Vector Symbolic Architecture (VSA) operations with balanced ternary {-1, 0, +1} representation. It achieves 58.5% higher information density than binary systems and provides SIMD-optimized implementations of bind, bundle, permute, and similarity operations. Key mathematical foundation: φ² + 1/φ² = 3.",
"creators": [
{
"name": "Vasilev, Dmitrii",
"affiliation": "Trinity Research",
"orcid": "0000-0000-0000-0000"
}
],
"keywords": [
"ternary-computing",
"vector-symbolic-architecture",
"hyperdimensional-computing",
"vsa",
"hdc",
"golden-ratio",
"balanced-ternary",
"bitnet",
"fpga",
"zig"
],
"license": "MIT",
"upload_type": "software",
"access_right": "open",
"related_identifiers": [
{
"identifier": "https://github.com/gHashTag/trinity",
"relation": "isSupplementTo",
"scheme": "url"
},
{
"identifier": "10.1007/s12559-009-9009-8",
"relation": "cites",
"scheme": "doi"
}
],
"references": [
"Kanerva, P. (2009). Hyperdimensional Computing. Cognitive Computation, 1(2), 139-159.",
"Plate, T.A. (2003). Holographic Reduced Representations. CSLI Publications.",
"Hayes, B. (2001). Third Base. American Scientist, 89(6), 490-494.",
"Kleyko, D. et al. (2022). Vector Symbolic Architectures as a Computing Framework. Proc. IEEE."
],
"version": "0.11.0"
}
112 changes: 112 additions & 0 deletions CITATION.cff
Original file line number Diff line number Diff line change
@@ -0,0 +1,112 @@
# This CITATION.cff file was generated for the Trinity project.
# See: https://citation-file-format.github.io/

cff-version: 1.2.0
title: "Trinity: Ternary Vector Symbolic Architecture Framework"
message: "If you use this software, please cite it as below."
type: software
version: 0.11.0
date-released: 2026-03-08
license: MIT
repository-code: "https://github.com/gHashTag/trinity"
url: "https://gHashTag.github.io/trinity/"
keywords:
- ternary-computing
- vector-symbolic-architecture
- hyperdimensional-computing
- golden-ratio
- balanced-ternary
- vsa
- hdc
- bitnet
- fpga

abstract: >-
Trinity is a ternary computing framework implementing Vector Symbolic
Architecture (VSA) operations with balanced ternary {-1, 0, +1} representation.
It achieves 58.5% higher information density than binary systems and provides
SIMD-optimized implementations of bind, bundle, permute, and similarity operations.
The framework includes a virtual machine, VIBEE specification language, and
FPGA synthesis targets. Key mathematical foundation: φ² + 1/φ² = 3.

authors:
- family-names: "Vasilev"
given-names: "Dmitrii"
orcid: "https://orcid.org/0000-0000-0000-0000"
affiliation: "Trinity Research"
email: "dmitrii@trinity.dev"

# Primary reference for citing Trinity
preferred-citation:
type: software
title: "Trinity: Ternary Vector Symbolic Architecture Framework"
authors:
- family-names: "Vasilev"
given-names: "Dmitrii"
year: 2026
url: "https://github.com/gHashTag/trinity"
version: 0.11.0

# Related academic references
references:
- type: article
title: "Hyperdimensional Computing: An Introduction to Computing in Distributed Representation with High-Dimensional Random Vectors"
authors:
- family-names: "Kanerva"
given-names: "Pentti"
journal: "Cognitive Computation"
volume: 1
issue: 2
start: 139
end: 159
year: 2009
doi: "10.1007/s12559-009-9009-8"

- type: book
title: "Holographic Reduced Representations"
authors:
- family-names: "Plate"
given-names: "Tony A."
publisher:
name: "CSLI Publications"
year: 2003
isbn: "978-1575864297"

- type: article
title: "Third Base"
authors:
- family-names: "Hayes"
given-names: "Brian"
journal: "American Scientist"
volume: 89
issue: 6
start: 490
end: 494
year: 2001

- type: article
title: "Vector Symbolic Architectures as a Computing Framework for Emerging Hardware"
authors:
- family-names: "Kleyko"
given-names: "Denis"
- family-names: "Rachkovskij"
given-names: "Dmitri A."
- family-names: "Osipov"
given-names: "Evgeny"
- family-names: "Rahimi"
given-names: "Abbas"
journal: "Proceedings of the IEEE"
year: 2022
doi: "10.1109/JPROC.2022.3209100"

- type: article
title: "The Era of 1-bit LLMs: All Large Language Models are in 1.58 Bits"
authors:
- family-names: "Ma"
given-names: "Shuming"
- family-names: "Wang"
given-names: "Hongyu"
- family-names: "Ma"
given-names: "Lingxiao"
year: 2024
url: "https://arxiv.org/abs/2402.17764"
100 changes: 100 additions & 0 deletions Dockerfile.reproducibility
Original file line number Diff line number Diff line change
@@ -0,0 +1,100 @@
# ══════════════════════════════════════════════════════════════════════════════
# TRINITY — Academic Reproducibility Environment
# ══════════════════════════════════════════════════════════════════════════════
# This Dockerfile creates a complete, reproducible environment for:
# - Building Trinity from source
# - Running all tests (3500+ tests)
# - Reproducing benchmark results
# - Verifying mathematical proofs
#
# Usage:
# docker build -f Dockerfile.reproducibility -t trinity-repro .
# docker run -it trinity-repro zig build test
# ══════════════════════════════════════════════════════════════════════════════

FROM ubuntu:22.04 AS base

LABEL maintainer="Trinity Research <dmitrii@trinity.dev>"
LABEL description="Trinity Reproducibility Environment for Academic Research"
LABEL version="0.11.0"

# Prevent interactive prompts
ENV DEBIAN_FRONTEND=noninteractive
ENV TZ=UTC

# Install system dependencies
RUN apt-get update && apt-get install -y --no-install-recommends \
ca-certificates \
curl \
wget \
git \
xz-utils \
build-essential \
python3 \
python3-pip \
&& rm -rf /var/lib/apt/lists/*

# ══════════════════════════════════════════════════════════════════════════════
# Install Zig 0.15.x (required version)
# ══════════════════════════════════════════════════════════════════════════════
ARG ZIG_VERSION=0.15.0-dev.367+a68210b2e
ARG ZIG_ARCH=x86_64-linux

RUN curl -L "https://ziglang.org/builds/zig-linux-x86_64-${ZIG_VERSION}.tar.xz" -o /tmp/zig.tar.xz \
&& mkdir -p /opt/zig \
&& tar -xf /tmp/zig.tar.xz -C /opt/zig --strip-components=1 \
&& rm /tmp/zig.tar.xz \
&& ln -s /opt/zig/zig /usr/local/bin/zig

# Verify Zig installation
RUN zig version

# ══════════════════════════════════════════════════════════════════════════════
# Create non-root user for reproducibility
# ══════════════════════════════════════════════════════════════════════════════
RUN useradd -m -u 1000 -s /bin/bash researcher
WORKDIR /home/researcher/trinity

# ══════════════════════════════════════════════════════════════════════════════
# Copy Trinity source code
# ══════════════════════════════════════════════════════════════════════════════
COPY --chown=researcher:researcher . .

# Switch to non-root user
USER researcher

# ══════════════════════════════════════════════════════════════════════════════
# Build Trinity
# ══════════════════════════════════════════════════════════════════════════════
RUN zig build

# ══════════════════════════════════════════════════════════════════════════════
# Verification commands (run as entrypoint)
# ══════════════════════════════════════════════════════════════════════════════

# Default: run all tests
CMD ["zig", "build", "test"]

# ══════════════════════════════════════════════════════════════════════════════
# Available commands:
# ══════════════════════════════════════════════════════════════════════════════
#
# Run all tests:
# docker run trinity-repro zig build test
#
# Run benchmarks:
# docker run trinity-repro zig build bench
#
# Verify VSA theorems:
# docker run trinity-repro zig test src/vsa/tests.zig
#
# Run VIBEE compiler:
# docker run trinity-repro zig build vibee -- help
#
# Interactive shell:
# docker run -it trinity-repro /bin/bash
#
# Build with specific flags:
# docker run trinity-repro zig build -Doptimize=ReleaseFast
#
# ══════════════════════════════════════════════════════════════════════════════
Loading
Loading