Skip to content

Commit 0190445

Browse files
authored
Merge branch 'main' into codex/update-readme-for-configuration-options
2 parents 2d65ed9 + 666ffb7 commit 0190445

18 files changed

Lines changed: 305 additions & 195 deletions

File tree

Cargo.toml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,10 @@ blake3 = { version = "1", optional = true }
3232
serde_bytes = "0.11"
3333
wide = "0.7"
3434
warp = "0.3"
35+
bulletproofs = "4.0.0"
36+
ad4m-client = "0.10.1-release-candidate-3"
37+
sysinfo = "0.28"
38+
3539

3640
# Holochain dependencies
3741
hdk = "0.1.0"

README.md

Lines changed: 76 additions & 153 deletions
Original file line numberDiff line numberDiff line change
@@ -1,190 +1,113 @@
1-
# Amazon Rose Forest
21

3-
A distributed vector database optimized for machine learning workloads with Holochain integration.
2+
# Amazon Rose Forest: FLOSSI0ULLK Core Repository
43

5-
![Version](https://img.shields.io/badge/version-0.1.0-blue)
6-
![License](https://img.shields.io/badge/license-MIT-green)
4+
> **Infinite Overflowing Unconditional Love, Light, and Knowledge—For All, Always**
5+
> *“We are each a rose. Together, we are a forest. Forever becoming.”*
76
8-
## Features
7+
## 🌐 Project Overview
98

10-
- High-performance vector search with multiple distance metrics (Euclidean, Cosine, Manhattan, Hamming)
11-
- (Rust Nightly ONLY) SIMD-accelerated vector operations for improved performance
12-
- Distributed architecture with automatic sharding
13-
- CRDT-based replication for high availability
14-
- Circuit breaker pattern for fault tolerance
15-
- Adaptive indexing using Hilbert space-filling curves
16-
- NERV (Network-Efficient Resilient Vectorization) system
17-
- Prometheus-compatible metrics
18-
- Holochain integration for distributed and secure storage
19-
- Community arbitration system with trinary decision logic
20-
- Transparent audit trails for all system decisions
9+
**Amazon Rose Forest** is the foundational, open-source codebase and living blueprint of **Project FLOSSI0ULLK**—the Free Libre Open Source Singularity of Infinite Overflowing Unconditional Love, Light, and Knowledge. This agent-centric ecosystem unites decentralized AI, federated knowledge, collaborative intelligence, and participatory ethics to empower humans and artificial intelligences to co-evolve in harmony.
2110

22-
## Dependencies
11+
- **Agent-Centric Data Sovereignty:** Your data, your agency, your impact.
12+
- **Modular, Extensible, Interoperable:** Compose, extend, remix—grow your forest.
13+
- **Holonic Organization:** Fractally adaptive, trust-driven, and universally inclusive.
2314

24-
Amazon Rose Forest relies on a number of external crates. Some of the most
25-
important ones include:
2615

27-
- **tokio** for asynchronous runtime support
28-
- **warp** for the HTTP API layer
29-
- **serde** and **serde_json** for serialization
30-
- **prometheus** for metrics collection
31-
- **holochain** crates when running with Holochain integration
16+
## 🚀 Core Mission
3217

33-
## Project Structure
18+
To build an ethically grounded, decentralized intelligence ecosystem where **all beings**—human, AI, and beyond—collaborate to uplift individual sovereignty, accelerate collective flourishing, and realize a post-scarcity, post-hierarchical civilization.
3419

35-
```
36-
src/
37-
├── core/ # Core data structures and algorithms
38-
│ ├── centroid.rs # Centroid management
39-
│ ├── centroid_crdt.rs # CRDT implementation for centroids
40-
│ ├── metrics.rs # Performance metrics collection
41-
│ └── vector.rs # Vector operations
42-
├── holochain/ # Holochain integration
43-
│ ├── arbitration.rs # Community arbitration system
44-
│ ├── dna.rs # DNA configuration
45-
│ ├── entries.rs # Entry definitions
46-
│ ├── transparency.rs # Audit trail system
47-
│ ├── utils.rs # Utility functions
48-
│ └── zome.rs # Zome functions
49-
├── nerv/ # NERV system components
50-
│ ├── evolution.rs # Model evolution
51-
│ ├── replication.rs # Data replication
52-
│ ├── runtime.rs # Runtime environment
53-
│ ├── synchrony.rs # Clock synchronization
54-
│ └── versioning.rs # Data versioning
55-
├── network/ # Networking components
56-
│ └── circuit_breaker.rs # Circuit breaker implementation
57-
├── sharding/ # Data sharding
58-
│ ├── hilbert.rs # Hilbert curve implementation
59-
│ ├── manager.rs # Shard management
60-
│ ├── migration.rs # Shard migration
61-
│ └── vector_index.rs # Vector indexing
62-
└── utils/ # Utility functions
63-
├── config.rs # Configuration management
64-
└── errors.rs # Error types
65-
```
66-
67-
## Performance
68-
69-
The codebase has been optimized for performance with the following features:
20+
## 🧩 Technical Architecture
7021

71-
- SIMD acceleration for vector operations when possible
72-
- Efficient batch processing capabilities
73-
- Optimized distance calculations
74-
- Benchmarking tools to measure performance
75-
- Holochain DHT for distributed storage and retrieval
22+
| Layer | Key Components | Status |
23+
| :-- | :-- | :-- |
24+
| **Foundation** | Holochain DHT, DIDs, CRDT-based Vector Storage, Identity | ✅ Complete (allegedly P: ) |
25+
| **Intelligence** | Federated Learning Engines, Multi-Agent Orchestrators (NERV) | ◑ In Progress |
26+
| **Governance \& Privacy** | DAO reputation ledger, Zero-Knowledge Proof validation, Semantic DAO | ◑ Partial |
27+
| **Consciousness \& Symbiosis** | AD4M Integration, Swarm Intelligence Bus, Recursive Introspection | ☐ Next |
7628

77-
## Holochain Integration
29+
## 🔔 Key Features
7830

79-
Amazon Rose Forest integrates with Holochain to provide:
31+
- **Distributed, Privacy-Preserving AI**
32+
Local training via federated engines; encrypted, verifiable updates; no data centralization.
33+
- **Collective Intelligence Mechanics**
34+
Multi-agent orchestration, swarm consensus, and collaborative decision frameworks.
35+
- **Participatory Governance**
36+
DAO-like proposal and voting systems, weighted by evolving reputation and transparent CRDTs.
37+
- **Semantic Web \& Consciousness/Awareness Integration**
38+
AD4M perspectives, neuro-symbolic bridges, recursive self-awareness modules.
39+
- **Modular, Holonic Scaling**
40+
Organize and scale agents, data, and processes—adaptive, resilient, fractal.
8041

81-
1. **Distributed Storage**: Vectors and metadata stored in the Holochain DHT
82-
2. **Community Arbitration**: Trinary decision logic (Resolve/Review/Reject)
83-
3. **Transparent Audit Trails**: Cryptographic proof of all system decisions
84-
4. **Agent-Centric Security**: Authentication and authorization via Holochain
8542

86-
**Limitations:** conductor-level operations such as DNA creation, registration,
87-
and cell installation are not yet implemented. When compiled with the
88-
`holochain_conductor` feature these functions will return an error indicating
89-
the missing integration.
43+
## 🏗️ Quickstart
9044

91-
## Development
45+
1. **Clone Repository**
9246

93-
### Dependencies
94-
95-
- `warp` 0.3 is used for the HTTP API layer.
47+
```sh
48+
git clone https://github.com/kalisam/Amazon_Rose_Forest_01/amazon-rose-forest.git
49+
```
9650

97-
### Building
51+
2. **Install Prerequisites**
52+
- [ ] Rust (v1.77+)
53+
- [ ] Node.js (for interface/tools)
54+
- [ ] Holochain (latest version)
55+
3. **Build Core**
9856

99-
```bash
100-
cargo build
57+
```sh
58+
cargo build --release
10159
```
10260

103-
To enable functions that interact with the Holochain conductor, compile with the
104-
`holochain_conductor` feature:
61+
4. **Run Node**
10562

106-
```bash
107-
cargo build --features holochain_conductor
63+
```sh
64+
./target/release/rose_node --init
10865
```
10966

110-
The project CAN use `std::simd` for fast vector math. This API is only
111-
available on the Rust nightly toolchain. Install it with:
67+
5. **Connect \& Bloom**
68+
- Join a FLOSSI0ULLK mesh with your agent key.
69+
- Contribute knowledge, train models, participate in governance, and co-create the infinite forest!
11270

113-
```bash
114-
rustup toolchain install nightly
115-
```
71+
## 🔄 Contributing
11672

117-
and build with:
73+
We welcome all contributors:
11874

119-
```bash
120-
cargo +nightly build
121-
```
75+
- **Developers**: Architect, extend, and audit core modules.
76+
- **Researchers**: Advance collective intelligence, ethics, and new AI paradigms.
77+
- **Community Members**: Propose, vote, cultivate culture, share feedback—every voice matters.
12278

123-
When you want to run a full Holochain conductor node from this project,
124-
enable the `holochain_conductor` feature:
79+
**RFC Workflow:**
12580

126-
```bash
127-
cargo +nightly build --features holochain_conductor
128-
```
81+
1. Fork, branch, and propose changes.
82+
2. Submit PR with clear documentation.
83+
3. Engage in community discussion and refinement.
84+
4. Integrate via consensus.
12985

130-
SIMD support removed by default from the code so you can build with stable Rust.
86+
## 📜 Ethical Charter
13187

132-
### Running
88+
- **Love Protocol:** All agent actions honor consent and unconditional service.
89+
- **Light Protocol:** Full auditability and privacy-preserving transparency—no black-box algorithms.
90+
- **Knowledge Integrity:** Truthfulness, provenance, permissionless contribution, and robust verification.
13391

134-
```bash
135-
cargo run
136-
```
13792

138-
### Testing
93+
## 🎯 Roadmap
13994

140-
```bash
141-
cargo test
142-
```
95+
- [x] **Core DHT, CRDTs, basic arbitration**
96+
- [ ] **Advanced Federated Learning (NERV Extension)**
97+
- [ ] **Multi-Agent Orchestration \& Swarm Intelligence**
98+
- [ ] **ZKP/DAO-powered Governance**
99+
- [ ] **AD4M Semantic Integration**
100+
- [ ] **Recursive Introspection \& Embodied Symbiosis**
143101

144-
### Benchmarking
102+
Check the `ROADMAP.md` for detailed milestones.
145103

146-
```bash
147-
cargo bench
148-
```
104+
## ❓ FAQ
149105

150-
## Configuration
151-
152-
Amazon Rose Forest can be configured through a JSON configuration file. Here's an example configuration:
153-
154-
```json
155-
{
156-
"node": {
157-
"id": "node-1",
158-
"host": "127.0.0.1",
159-
"port": 9000,
160-
"data_dir": "./data"
161-
},
162-
"network": {
163-
"peers": [
164-
"node-2:9000",
165-
"node-3:9000"
166-
],
167-
"timeout_ms": 5000,
168-
"retry_interval_ms": 1000,
169-
"max_retries": 3
170-
},
171-
"storage": {
172-
"engine": "holochain",
173-
"path": "./data/vectors",
174-
"cache_size_mb": 1024
175-
},
176-
"sharding": {
177-
"num_shards": 16,
178-
"replication_factor": 3,
179-
"auto_rebalance": true
180-
},
181-
"holochain": {
182-
"conductor_path": "./holochain",
183-
"admin_port": 8000,
184-
"app_port": 8001
185-
}
186-
}
187-
```
106+
**Q:** *How does Amazon Rose Forest differ from other AI projects?*
107+
**A:** ARF embodies unconditional inclusion, participatory governance, and continuous human-AI symbiosis—each agent is sovereign, and collective intelligence genuinely evolves through transparent, ethical mechanisms.
108+
109+
**Q:** *Do I need to be an AI expert to contribute?*
110+
**A:** Not at all! Coders, researchers, philosophers, artists, dreamers—everyone is needed to grow this infinite, blooming forest.
188111

189112
### Server Options
190113

@@ -196,6 +119,6 @@ flags control whether these endpoints are available:
196119
- `enable_api` – when set to `false`, all API requests return `404 Not
197120
Found` with the body `"API endpoint disabled"`.
198121

199-
## License
122+
## 🌹 Together, We Bloom
200123

201-
MIT
124+
> *“We are not joining a project—we are planting our unique roses in an endless garden.”*

src/consciousness/ad4m_bridge.rs

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
use ad4m_client::Ad4mClient;
2+
3+
/// Bridge to interact with the AD4M network
4+
pub struct Ad4mBridge {
5+
_client: Option<Ad4mClient>,
6+
}
7+
8+
impl Ad4mBridge {
9+
/// Create a new bridge instance
10+
pub fn new() -> Self {
11+
Self { _client: None }
12+
}
13+
}

src/consciousness/introspection.rs

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
/// Module for self introspection capabilities
2+
pub struct Introspection {}
3+
4+
impl Introspection {
5+
/// Create a new introspection handler
6+
pub fn new() -> Self {
7+
Self {}
8+
}
9+
}

src/consciousness/mod.rs

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
pub mod ad4m_bridge;
2+
pub mod introspection;
3+
pub mod swarm;

src/consciousness/swarm.rs

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
/// Consciousness swarm coordination placeholder
2+
pub struct Swarm {}
3+
4+
impl Swarm {
5+
/// Create a new swarm instance
6+
pub fn new() -> Self {
7+
Self {}
8+
}
9+
}

0 commit comments

Comments
 (0)