the-architecture

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

the-architecture

★ 15 Open GitHub ↗

MIT licensed user-owned AI runtime: 4 components, 2 APIs, zero lock-in. Your Memory is the platform.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Personal AI Architecture

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://raw.githubusercontent.com/Personal-AI-Architecture/the-architecture/main/LICENSE)

An open architecture for personal AI systems. This repository is now the documentation and standards source of truth.

<p align="center">
  <a href="https://personalaiarchitecture.org">Website</a> · <a href="https://github.com/Personal-AI-Architecture/ts-architecture-template">TypeScript Template</a> · <a href="https://github.com/BrainDriveAI/braindrive">BrainDrive (built on this)</a> · <a href="docs/in-depth-overview/foundation-spec.md">Foundation Spec</a> · <a href="https://youtube.com/playlist?list=PL_rTgQnnMXsVkg29Lm9syjUyVQmRG_4y_">Free Course</a>
</p>

## Repository Focus

This repository is documentation-first.

- Architecture principles and specifications
- API and schema contracts
- Blueprint and conformance guidance
- Documentation site content

Implementation/runtime code lives in the architecture template repository.

## If You Need the Implementation

Use the implementation template repository for runnable code and execution tooling.

- TypeScript architecture template: [Personal-AI-Architecture/ts-architecture-template](https://github.com/Personal-AI-Architecture/ts-architecture-template)

## What You Get Here

| Resource | What it is |
|----------|------------|
| [Foundation spec](docs/in-depth-overview/foundation-spec.md) | Complete architecture: components, contracts, principles, responsibility matrix |
| [Component specs](docs/) | Detailed specs for Memory, Agent Loop, Gateway, Auth, Tools, Models |
| [OpenAPI + JSON Schema](specs/) | Machine-verifiable boundary contracts |
| [Blueprints](docs/blueprints/) | Spec, schema, conformance guidance, drift guard, implementation prompts |
| [Architecture primer](docs/ai-agent-docs/) | Token-optimized references for AI-assisted development |
| [Lock-in gate](docs/in-depth-overview/lockin-gate.md) | Zero lock-in checks and enforcement criteria |

## Documentation

| I want to... | Start here |
|--------------|------------|
| Understand the architecture | [Foundation spec](docs/in-depth-overview/foundation-spec.md) |
| Build with AI assistance | [Architecture primer](docs/ai-agent-docs/) |
| Build a component | [Blueprints](docs/blueprints/) |
| Verify conformance | [Conformance guide](docs/in-depth-overview/conformance/) |
| Check lock-in risks | [Lock-in gate](docs/in-depth-overview/lockin-gate.md) and [Lock-in audit](docs/in-depth-overview/lockin-audit.md) |

For AI agents: start with [AGENT.md](AGENT.md).

## Contributing

We welcome pull requests for documentation, contracts, and specification improvements.

See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidance.

## License

MIT — see [LICENSE](LICENSE).

the-architecture

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README