pip and readme

This commit is contained in:
Kye Gomez 2026-04-19 08:33:09 -04:00
parent 806a8da1d6
commit 299a0cdb0a
4 changed files with 388 additions and 54 deletions

324
.gitignore vendored
View File

@ -1,15 +1,96 @@
# Byte-compiled / optimized / DLL files
__pycache__/
*.py[codz]
*$py.class
.venv/
.env
image/
audio/
video/
artifacts_three
dataframe/
.ruff_cache
target/
Cargo.lock
.claude/
.pytest_cache
dist
databases
static/generated
conversations/
sjfdkdjad9si_dsksdjks
next_swarms_update.txt
.pytest_cache
infra.md
runs
Financial-Analysis-Agent_state.json
conversations/
models/
evolved_gpt2_models/
experimental
ffn_alternatives
artifacts_five
experimental/
encryption
errors
chroma
new_experimental/
agent_workspace
.pt
Accounting Assistant_state.json
Unit Testing Agent_state.json
sec_agent
Devin_state.json
poetry.lock
hire_researchers
agent_workspace
json_logs
Medical Image Diagnostic Agent_state.json
flight agent_state.json
D_state.json
artifacts_six
artifacts_seven
swarms/__pycache__
artifacts_once
transcript_generator.json
venv
.DS_Store
Cargo.lock
.DS_STORE
artifacts_logs
Cargo.lock
Medical Treatment Recommendation Agent_state.json
swarms/agents/.DS_Store
artifacts_two
logs
T_state.json
_build
conversation.txt
t1_state.json
stderr_log.txt
t2_state.json
.vscode
.DS_STORE
# Byte-compiled / optimized / DLL files
Transcript Generator_state.json
__pycache__/
*.py[cod]
*$py.class
.grit
swarm-worker-01_state.json
error.txt
Devin Worker 2_state.json
# C extensions
*.so
.ruff_cache
errors.txt
Autonomous-Agent-XYZ1B_state.json
# Distribution / packaging
.Python
build/
experimental/
develop-eggs/
dist/
downloads/
@ -47,7 +128,7 @@ htmlcov/
nosetests.xml
coverage.xml
*.cover
*.py.cover
*.py,cover
.hypothesis/
.pytest_cache/
cover/
@ -82,7 +163,7 @@ target/
# IPython
profile_default/
ipython_config.py
.DS_Store
# pyenv
# For a library or package, you might want to ignore these files since the code is
# intended to run in multiple environments; otherwise, check them in:
@ -95,35 +176,20 @@ ipython_config.py
# install all needed dependencies.
#Pipfile.lock
# UV
# Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
# This is especially recommended for binary packages to ensure reproducibility, and is more
# commonly ignored for libraries.
#uv.lock
# poetry
# Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
# This is especially recommended for binary packages to ensure reproducibility, and is more
# commonly ignored for libraries.
# https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
#poetry.lock
#poetry.toml
# pdm
# Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
# pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
# https://pdm-project.org/en/latest/usage/project/#working-with-version-control
#pdm.lock
#pdm.toml
.pdm-python
.pdm-build/
# pixi
# Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
#pixi.lock
# Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
# in the .venv directory. It is recommended not to include this directory in version control.
.pixi
# pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
# in version control.
# https://pdm.fming.dev/#use-with-ide
.pdm.toml
# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
__pypackages__/
@ -137,7 +203,6 @@ celerybeat.pid
# Environments
.env
.envrc
.venv
env/
venv/
@ -175,34 +240,191 @@ cython_debug/
# and can be added to the global gitignore or merged into this file. For a more nuclear
# option (not recommended) you can uncomment the following to ignore the entire idea folder.
#.idea/
.vscode/settings.json
# -*- mode: gitignore; -*-
*~
\#*\#
/.emacs.desktop
/.emacs.desktop.lock
*.elc
auto-save-list
tramp
.\#*
# Abstra
# Abstra is an AI-powered process automation framework.
# Ignore directories containing user credentials, local state, and settings.
# Learn more at https://abstra.io/docs
.abstra/
# Org-mode
.org-id-locations
*_archive
# Visual Studio Code
# Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore
# that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
# and can be added to the global gitignore or merged into this file. However, if you prefer,
# you could uncomment the following to ignore the entire vscode folder
# .vscode/
# flymake-mode
*_flymake.*
# Ruff stuff:
.ruff_cache/
# eshell files
/eshell/history
/eshell/lastdir
# PyPI configuration file
.pypirc
# elpa packages
/elpa/
# Cursor
# Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
# exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
# refer to https://docs.cursor.com/context/ignore-files
.cursorignore
.cursorindexingignore
# reftex files
*.rel
# AUCTeX auto folder
/auto/
# cask packages
.cask/
dist/
# Flycheck
flycheck_*.el
# server auth directory
/server/
# projectiles files
.projectile
# directory configuration
.dir-locals.el
# network security
/network-security.data
# Agent Skills - User-created skill directories
# Keep example_skills/ committed for reference
# Ignore common user skill directory patterns
/skills/
/my_skills/
/custom_skills/
/*_skills/
!example_skills/
# pyenv
# For a library or package, you might want to ignore these files since the code is
# intended to run in multiple environments; otherwise, check them in:
# .python-version
# pipenv
# According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
# However, in case of collaboration, if having platform-specific dependencies or dependencies
# having no cross-platform support, pipenv may install dependencies that don't work, or not
# install all needed dependencies.
#Pipfile.lock
# poetry
# Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
# This is especially recommended for binary packages to ensure reproducibility, and is more
# commonly ignored for libraries.
# https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
#poetry.lock
# pdm
# Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
#pdm.lock
# pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
# in version control.
# https://pdm.fming.dev/#use-with-ide
.pdm.toml
# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
__pypackages__/
# Celery stuff
celerybeat-schedule
celerybeat.pid
# SageMath parsed files
*.sage.py
# Environments
.env
.venv
env/
venv/
ENV/
env.bak/
venv.bak/
# Spyder project settings
.spyderproject
.spyproject
# Rope project settings
.ropeproject
# mkdocs documentation
/site
# mypy
.mypy_cache/
.dmypy.json
dmypy.json
# Pyre type checker
.pyre/
# pytype static type analyzer
.pytype/
# Cython debug symbols
cython_debug/
# PyCharm
# JetBrains specific template is maintained in a separate JetBrains.gitignore that can
# be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
# and can be added to the global gitignore or merged into this file. For a more nuclear
# option (not recommended) you can uncomment the following to ignore the entire idea folder.
#.idea/
.vscode/settings.json
# -*- mode: gitignore; -*-
*~
\#*\#
/.emacs.desktop
/.emacs.desktop.lock
*.elc
auto-save-list
tramp
.\#*
# Org-mode
.org-id-locations
*_archive
# flymake-mode
*_flymake.*
# eshell files
/eshell/history
/eshell/lastdir
# elpa packages
/elpa/
# reftex files
*.rel
# AUCTeX auto folder
/auto/
# cask packages
.cask/
dist/
# Flycheck
flycheck_*.el
# server auth directory
/server/
# projectiles files
.projectile
# directory configuration
.dir-locals.el
# network security
/network-security.data
# Marimo
marimo/_static/
marimo/_lsp/
__marimo__/

View File

@ -8,9 +8,9 @@ OpenMythos is an open-source, theoretical implementation of the Claude Mythos mo
## Installation
```bash
git clone https://github.com/The-Swarm-Corporation/OpenMythos.git
cd OpenMythos
pip install -r requirements.txt
pip install open-mythos
#uv pip install open-mythos
```
## Usage

View File

@ -0,0 +1,35 @@
from open_mythos.main import (
MythosConfig,
RMSNorm,
GQAttention,
MLAttention,
Expert,
MoEFFN,
LoRAAdapter,
TransformerBlock,
LTIInjection,
ACTHalting,
RecurrentBlock,
OpenMythos,
precompute_rope_freqs,
apply_rope,
loop_index_embedding,
)
__all__ = [
"MythosConfig",
"RMSNorm",
"GQAttention",
"MLAttention",
"Expert",
"MoEFFN",
"LoRAAdapter",
"TransformerBlock",
"LTIInjection",
"ACTHalting",
"RecurrentBlock",
"OpenMythos",
"precompute_rope_freqs",
"apply_rope",
"loop_index_embedding",
]

77
pyproject.toml Normal file
View File

@ -0,0 +1,77 @@
[build-system]
requires = ["poetry-core>=1.0.0"]
build-backend = "poetry.core.masonry.api"
[tool.poetry]
name = "open-mythos"
version = "0.1.0"
description = "OpenMythos — open-source theoretical reconstruction of the Claude Mythos Recurrent-Depth Transformer architecture"
license = "MIT"
authors = ["Kye Gomez <kye@swarms.world>"]
homepage = "https://github.com/The-Swarm-Corporation/OpenMythos"
documentation = "https://github.com/The-Swarm-Corporation/OpenMythos/blob/main/docs/open_mythos.md"
readme = "README.md"
repository = "https://github.com/The-Swarm-Corporation/OpenMythos"
keywords = [
"artificial intelligence",
"deep learning",
"transformers",
"recurrent transformers",
"looped transformers",
"mixture of experts",
"multi-latent attention",
"grouped query attention",
"adaptive computation time",
"recurrent depth transformer",
"LTI stability",
"inference-time scaling",
]
classifiers = [
"Development Status :: 3 - Alpha",
"Intended Audience :: Science/Research",
"Topic :: Scientific/Engineering :: Artificial Intelligence",
"License :: OSI Approved :: MIT License",
"Programming Language :: Python :: 3.10",
]
[tool.poetry.dependencies]
python = ">=3.10,<4.0"
torch = "*"
[tool.poetry.group.lint.dependencies]
black = ">=23.1,<27.0"
ruff = ">=0.5.1,<0.15.9"
[tool.poetry.group.test.dependencies]
pytest = ">=8.1.1,<10.0.0"
[tool.poetry.group.dev.dependencies]
black = "*"
ruff = "*"
pytest = "*"
[tool.ruff]
line-length = 88
[tool.black]
target-version = ["py310"]
line-length = 88
include = '\.pyi?$'
exclude = '''
/(
\.git
| \.hg
| \.mypy_cache
| \.tox
| \.venv
| _build
| buck-out
| build
| dist
| docs
)/
'''