# Aether Framework
> Human-readable, AI-interpretable, machine-consumable.
[](https://pypi.org/project/jintra-aether/)
[](https://www.python.org/downloads/)
[](https://fsl.software/)
Aether is a lightweight, schema-driven framework for structured content authoring and validation with AI assistance. It enables humans and AI to collaborate on creating, validating, and distributing structured content.
## Features
- ✅ **Schema Validation** - JSON Schema Draft 7 with custom Aether extensions (`media`, `markdown`)
- ✅ **Entity Collections** - Hierarchical content organization with automatic reference resolution
- ✅ **Bundle Distribution** - Package complete projects as portable `.aetherpack` archives
- ✅ **AI Integration** - Native support for Cursor AI and Model Context Protocol (MCP)
- ✅ **CLI & Python API** - Use from command line or integrate into Python applications
- ✅ **Comprehensive** - Project scaffolding, introspection, validation context, and more
## Installation
```bash
pip install jintra-aether
```
## Quick Start
### Define a Schema
Create `blog.aether`:
```yaml
id: blog
spec_version: "1.0.0"
version: "1.0.0"
title: Blog
structure:
posts:
type: array
items:
$ref: "#/objects/Post"
objects:
Post:
type: object
properties:
title: { type: string }
content: { type: markdown }
author: { type: string }
published: { type: boolean }
```
### Create Content
```bash
# Create project structure
aether scaffold blog.aether my-blog --examples
# Validate project
aether validate-project my-blog
# Bundle for distribution
aether bundle my-blog -o blog.aetherpack
```
### Use in Python
```python
import aether
# Load and validate
schema = aether.load_schema("blog.aether")
project = aether.open_bundle("blog.aetherpack")
aether.validate_project(project, schema)
# Access resolved content
for post in project['posts']:
print(f"Title: {post['title']}")
print(f"Author: {post['author']}")
```
## Use Cases
### 📚 Documentation & Reports
- Technical documentation with automatic cross-references
- Corporate reports with validated data structures
- Static site generators with schema-driven content
### 🎨 Interactive Digital Experiences
- Educational simulations with validated entity systems
- Narrative platforms with branching storylines
- Interactive media with decision trees
### 🧠 Knowledge Management
- Portable content packages for AI agents
- Validated knowledge bases
- Schema-driven data distribution
## Documentation
- 📖 [Getting Started](docs/getting-started/quickstart.md)
- 📘 [Concepts](docs/concepts/index.md) - Schemas, entities, collections
- 🔧 [CLI Reference](docs/cli/index.md) - Command-line tools
- 🐍 [Python API](docs/api-reference/index.md) - Library reference
- 🤖 [AI Integration](docs/advanced/ai-integration.md) - Cursor AI & MCP
- 📄 [Whitepaper](AETHER-WHITEPAPER.md) - Vision and architecture
## Examples
Check out the [`examples/`](examples/) directory for complete working projects:
- **aether-docs** - Self-documenting: Aether's own documentation as an Aether project
## Development
```bash
# Clone repository
git clone https://github.com/jintra-jayce/aether.git
cd aether
# Install dependencies
pip install -e .
# Run tests
pytest
```
## VS Code Extension
For the best development experience, install [**aether-vscode**](https://github.com/jintra-jayce/aether-vscode):
- Real-time schema validation
- IntelliSense for entity references
- AI-powered content assistance
- Visual project navigation
## License
Functional Source License, Version 1.1, MIT Future License (FSL-1.1-MIT)
- Free to use for any purpose except creating competing products
- Automatically converts to MIT License after 2 years (January 1, 2027)
- See [LICENSE](LICENSE) for full terms
## Contributing
Contributions welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) before submitting pull requests.
## Contact
- **Issues**: [GitHub Issues](https://github.com/jintra-jayce/aether/issues)
- **Email**: jayce@jintra.io
- **License Questions**: jayce@jintra.io
## Acknowledgments
Copyright © 2025 Jintra Software Solutions LLC
Raw data
{
"_id": null,
"home_page": null,
"name": "jintra-aether",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "schema, validation, content, yaml, json, structured-data",
"author": "Jayce",
"author_email": "jayce@jintra.io",
"download_url": "https://files.pythonhosted.org/packages/7a/36/01cb0d776742ccbc4eb1e06bb2b02decc7fbfe68456aa1dbc3f1a425cc33/jintra_aether-1.0.3.tar.gz",
"platform": null,
"description": "# Aether Framework\n\n> Human-readable, AI-interpretable, machine-consumable.\n\n[](https://pypi.org/project/jintra-aether/)\n[](https://www.python.org/downloads/)\n[](https://fsl.software/)\n\nAether is a lightweight, schema-driven framework for structured content authoring and validation with AI assistance. It enables humans and AI to collaborate on creating, validating, and distributing structured content.\n\n## Features\n\n- \u2705 **Schema Validation** - JSON Schema Draft 7 with custom Aether extensions (`media`, `markdown`)\n- \u2705 **Entity Collections** - Hierarchical content organization with automatic reference resolution\n- \u2705 **Bundle Distribution** - Package complete projects as portable `.aetherpack` archives\n- \u2705 **AI Integration** - Native support for Cursor AI and Model Context Protocol (MCP)\n- \u2705 **CLI & Python API** - Use from command line or integrate into Python applications\n- \u2705 **Comprehensive** - Project scaffolding, introspection, validation context, and more\n\n## Installation\n\n```bash\npip install jintra-aether\n```\n\n## Quick Start\n\n### Define a Schema\n\nCreate `blog.aether`:\n\n```yaml\nid: blog\nspec_version: \"1.0.0\"\nversion: \"1.0.0\"\ntitle: Blog\n\nstructure:\n posts:\n type: array\n items:\n $ref: \"#/objects/Post\"\n\nobjects:\n Post:\n type: object\n properties:\n title: { type: string }\n content: { type: markdown }\n author: { type: string }\n published: { type: boolean }\n```\n\n### Create Content\n\n```bash\n# Create project structure\naether scaffold blog.aether my-blog --examples\n\n# Validate project\naether validate-project my-blog\n\n# Bundle for distribution\naether bundle my-blog -o blog.aetherpack\n```\n\n### Use in Python\n\n```python\nimport aether\n\n# Load and validate\nschema = aether.load_schema(\"blog.aether\")\nproject = aether.open_bundle(\"blog.aetherpack\")\naether.validate_project(project, schema)\n\n# Access resolved content\nfor post in project['posts']:\n print(f\"Title: {post['title']}\")\n print(f\"Author: {post['author']}\")\n```\n\n## Use Cases\n\n### \ud83d\udcda Documentation & Reports\n- Technical documentation with automatic cross-references\n- Corporate reports with validated data structures\n- Static site generators with schema-driven content\n\n### \ud83c\udfa8 Interactive Digital Experiences\n- Educational simulations with validated entity systems\n- Narrative platforms with branching storylines\n- Interactive media with decision trees\n\n### \ud83e\udde0 Knowledge Management\n- Portable content packages for AI agents\n- Validated knowledge bases\n- Schema-driven data distribution\n\n## Documentation\n\n- \ud83d\udcd6 [Getting Started](docs/getting-started/quickstart.md)\n- \ud83d\udcd8 [Concepts](docs/concepts/index.md) - Schemas, entities, collections\n- \ud83d\udd27 [CLI Reference](docs/cli/index.md) - Command-line tools\n- \ud83d\udc0d [Python API](docs/api-reference/index.md) - Library reference\n- \ud83e\udd16 [AI Integration](docs/advanced/ai-integration.md) - Cursor AI & MCP\n- \ud83d\udcc4 [Whitepaper](AETHER-WHITEPAPER.md) - Vision and architecture\n\n## Examples\n\nCheck out the [`examples/`](examples/) directory for complete working projects:\n\n- **aether-docs** - Self-documenting: Aether's own documentation as an Aether project\n\n## Development\n\n```bash\n# Clone repository\ngit clone https://github.com/jintra-jayce/aether.git\ncd aether\n\n# Install dependencies\npip install -e .\n\n# Run tests\npytest\n```\n\n## VS Code Extension\n\nFor the best development experience, install [**aether-vscode**](https://github.com/jintra-jayce/aether-vscode):\n\n- Real-time schema validation\n- IntelliSense for entity references\n- AI-powered content assistance\n- Visual project navigation\n\n## License\n\nFunctional Source License, Version 1.1, MIT Future License (FSL-1.1-MIT)\n\n- Free to use for any purpose except creating competing products\n- Automatically converts to MIT License after 2 years (January 1, 2027)\n- See [LICENSE](LICENSE) for full terms\n\n## Contributing\n\nContributions welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) before submitting pull requests.\n\n## Contact\n\n- **Issues**: [GitHub Issues](https://github.com/jintra-jayce/aether/issues)\n- **Email**: jayce@jintra.io\n- **License Questions**: jayce@jintra.io\n\n## Acknowledgments\n\nCopyright \u00a9 2025 Jintra Software Solutions LLC\n\n\n",
"bugtrack_url": null,
"license": "FSL-1.1-MIT",
"summary": "A lightweight, extensible framework for structured content authoring and validation with AI assistance",
"version": "1.0.3",
"project_urls": {
"Documentation": "https://github.com/jintra-jayce/aether",
"Homepage": "https://github.com/jintra-jayce/aether",
"Repository": "https://github.com/jintra-jayce/aether"
},
"split_keywords": [
"schema",
" validation",
" content",
" yaml",
" json",
" structured-data"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "a0f1a893d50adfa6a933a7784a1ce823029bad9cab445237a85c0a43aee142d2",
"md5": "49567f00d23de931e36efdbb749a63a0",
"sha256": "67b5a371d896b78a6a532222cd25d8dc0c77445a727139fd8d35506e47dfe672"
},
"downloads": -1,
"filename": "jintra_aether-1.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "49567f00d23de931e36efdbb749a63a0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 51940,
"upload_time": "2025-10-09T16:04:08",
"upload_time_iso_8601": "2025-10-09T16:04:08.404240Z",
"url": "https://files.pythonhosted.org/packages/a0/f1/a893d50adfa6a933a7784a1ce823029bad9cab445237a85c0a43aee142d2/jintra_aether-1.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "7a3601cb0d776742ccbc4eb1e06bb2b02decc7fbfe68456aa1dbc3f1a425cc33",
"md5": "3993ac3895d93fd4937d313090605424",
"sha256": "3451fee1ff93c5b24000249ddf79a2b19e5bf978696512163ef30c7e3f03a50a"
},
"downloads": -1,
"filename": "jintra_aether-1.0.3.tar.gz",
"has_sig": false,
"md5_digest": "3993ac3895d93fd4937d313090605424",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 43885,
"upload_time": "2025-10-09T16:04:09",
"upload_time_iso_8601": "2025-10-09T16:04:09.599462Z",
"url": "https://files.pythonhosted.org/packages/7a/36/01cb0d776742ccbc4eb1e06bb2b02decc7fbfe68456aa1dbc3f1a425cc33/jintra_aether-1.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-09 16:04:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jintra-jayce",
"github_project": "aether",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "jintra-aether"
}
JSON
