redundanet 2.0.0__py3-none-any.whl

redundanet-2.0.0.dist-info/METADATA

@@ -0,0 +1,265 @@
+Metadata-Version: 2.1
+Name: redundanet
+Version: 2.0.0
+Summary: Distributed encrypted storage on a mesh VPN network
+Home-page: https://github.com/alessandrodefilippo/redundanet
+License: MIT
+Keywords: distributed-storage,vpn,encryption,mesh-network,tahoe-lafs
+Author: Alessandro De Filippo
+Author-email: alessandro@example.com
+Requires-Python: >=3.11,<4.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Security :: Cryptography
+Classifier: Topic :: System :: Distributed Computing
+Classifier: Topic :: System :: Networking
+Requires-Dist: gitpython (>=3.1,<4.0)
+Requires-Dist: httpx (>=0.26,<0.27)
+Requires-Dist: jinja2 (>=3.1,<4.0)
+Requires-Dist: jsonschema (>=4.21,<5.0)
+Requires-Dist: psutil (>=5.9,<6.0)
+Requires-Dist: pydantic (>=2.5,<3.0)
+Requires-Dist: pydantic-settings (>=2.1,<3.0)
+Requires-Dist: python-gnupg (>=0.5,<0.6)
+Requires-Dist: pyyaml (>=6.0,<7.0)
+Requires-Dist: rich (>=13.7,<14.0)
+Requires-Dist: structlog (>=24.1,<25.0)
+Requires-Dist: typer[all] (>=0.9.0,<0.10.0)
+Requires-Dist: watchdog (>=4.0,<5.0)
+Project-URL: Documentation, https://redundanet.readthedocs.io
+Project-URL: Repository, https://github.com/alessandrodefilippo/redundanet
+Description-Content-Type: text/markdown
+
+# RedundaNet - Distributed Encrypted Storage Network
+
+RedundaNet is a distributed, encrypted storage system built on a secure mesh VPN network. It enables users to contribute storage resources to a collective grid while maintaining privacy through end-to-end encryption.
+
+## Features
+
+- **Decentralized Architecture**: No central authority or single point of failure
+- **End-to-End Encryption**: Data is encrypted before leaving the user's device using Tahoe-LAFS
+- **GPG-Based Authentication**: Secure node identity verification
+- **Private Networking**: Secure Tinc mesh VPN isolates the storage network from the public internet
+- **Erasure Coding**: Data is split and distributed across multiple nodes (3-of-10 scheme by default)
+- **Resource Sharing**: Users contribute resources and benefit from the collective capacity
+- **Containerized Deployment**: Easy setup with Docker Compose
+- **Python-Based CLI**: Modern CLI with Typer for easy management
+
+## Architecture
+
+```mermaid
+graph TD
+    subgraph "User Node"
+        A[redundanet CLI] --> B[Tahoe Client]
+        B --> C[Tinc VPN]
+    end
+
+    subgraph "Storage Node 1"
+        D[Tinc VPN] --> E[Tahoe Storage]
+        E --> F[Local Storage]
+    end
+
+    subgraph "Storage Node 2"
+        G[Tinc VPN] --> H[Tahoe Storage]
+        H --> I[Local Storage]
+    end
+
+    subgraph "Introducer Node"
+        J[Tinc VPN] --> K[Tahoe Introducer]
+    end
+
+    C -->|Encrypted VPN| D
+    C -->|Encrypted VPN| G
+    C -->|Encrypted VPN| J
+
+    K -.->|Introduction Services| B
+    K -.->|Introduction Services| E
+    K -.->|Introduction Services| H
+```
+
+## Quick Start
+
+### Prerequisites
+
+- Python 3.11+
+- Docker and Docker Compose
+- GPG (for key management)
+
+### Installation
+
+#### Using pip (recommended)
+
+```bash
+pip install redundanet
+```
+
+#### Using Poetry (for development)
+
+```bash
+git clone https://github.com/adefilippo83/project-earthgrid.git
+cd project-earthgrid
+poetry install
+```
+
+### Initialize a Node
+
+```bash
+# Interactive setup
+redundanet init
+
+# Or with options
+redundanet init --node-name my-node --vpn-ip 10.100.0.10
+```
+
+### Start Services with Docker
+
+```bash
+# Start as a storage node
+docker compose -f docker/docker-compose.yml --profile storage up -d
+
+# Start as a client only
+docker compose -f docker/docker-compose.yml --profile client up -d
+
+# Start as an introducer (network coordinator)
+docker compose -f docker/docker-compose.yml --profile introducer up -d
+```
+
+### Check Status
+
+```bash
+redundanet status
+```
+
+## CLI Commands
+
+```
+redundanet --help
+
+Commands:
+  init        Initialize a new node
+  status      Show node and network status
+  sync        Sync manifest from repository
+  validate    Validate manifest file
+
+  node        Node management commands
+    list      List all nodes in the network
+    info      Show detailed node information
+    add       Add a new node to manifest
+    remove    Remove a node from manifest
+
+  network     Network management
+    join      Join an existing network
+    leave     Leave the network
+    peers     Show connected peers
+    vpn       VPN management (start/stop/status)
+
+  storage     Storage management
+    status    Show storage status
+    mount     Mount Tahoe filesystem
+    unmount   Unmount filesystem
+    upload    Upload a file
+    download  Download a file
+```
+
+## Configuration
+
+RedundaNet uses a YAML manifest file to define network configuration:
+
+```yaml
+network:
+  name: my-network
+  version: "1.0.0"
+  domain: redundanet.local
+  vpn_network: 10.100.0.0/16
+
+tahoe:
+  shares_needed: 3
+  shares_happy: 7
+  shares_total: 10
+  introducer_furl: pb://...
+
+nodes:
+  - name: node1
+    internal_ip: 192.168.1.10
+    vpn_ip: 10.100.0.1
+    public_ip: 1.2.3.4
+    gpg_key_id: ABCD1234
+    roles: [introducer, storage]
+    storage_contribution: 500GB
+```
+
+## Development
+
+### Setup Development Environment
+
+```bash
+# Clone repository
+git clone https://github.com/adefilippo83/project-earthgrid.git
+cd project-earthgrid
+
+# Install dependencies
+make install
+
+# Run tests
+make test
+
+# Run linting
+make lint
+
+# Run type checking
+make type-check
+```
+
+### Project Structure
+
+```
+redundanet/
+├── src/redundanet/          # Main Python package
+│   ├── cli/                 # Typer CLI commands
+│   ├── core/                # Core business logic
+│   ├── vpn/                 # Tinc VPN management
+│   ├── storage/             # Tahoe-LAFS integration
+│   ├── auth/                # GPG authentication
+│   ├── network/             # Network utilities
+│   └── utils/               # Shared utilities
+├── docker/                  # Docker configurations
+├── tests/                   # Test suite
+├── docs/                    # Documentation
+└── manifests/               # Example manifests
+```
+
+## Documentation
+
+- [Installation Guide](docs/installation.md)
+- [Quick Start Guide](docs/quickstart.md)
+- [Configuration Reference](docs/configuration.md)
+- [Architecture Overview](docs/architecture.md)
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Make your changes
+4. Run tests (`make test`)
+5. Run linting (`make lint`)
+6. Commit your changes (`git commit -m 'Add amazing feature'`)
+7. Push to the branch (`git push origin feature/amazing-feature`)
+8. Open a Pull Request
+
+## License
+
+This project is licensed under the GPL License - see the [LICENSE](LICENSE) file for details.
+
+## Acknowledgments
+
+- [Tahoe-LAFS](https://tahoe-lafs.org/) - Distributed storage system
+- [Tinc VPN](https://www.tinc-vpn.org/) - Mesh VPN daemon
+- [Typer](https://typer.tiangolo.com/) - CLI framework
+

redundanet-2.0.0.dist-info/RECORD

@@ -0,0 +1,37 @@
+redundanet/__init__.py,sha256=alb0XFwGxNY-c3R7wZtFBRluszSmqROQ-Vo7Um1F7Xc,398
+redundanet/__main__.py,sha256=sI1D-Mn0JeICtGPuNLp-uthhIQxOB_6_9Avf1-iOXLQ,151
+redundanet/auth/__init__.py,sha256=BlmLa620gKsRdiD3d8tsDDweA9kI_fTBY9bxM6jtiyU,202
+redundanet/auth/gpg.py,sha256=OG6Gdo19TYzVsyfp9-a8BLxV79gX_P3GcyMe8H_rmh4,9098
+redundanet/auth/keyserver.py,sha256=1zNIOIY62JaAPNWVjZaBHlx2fSN601WsGsR_KizdiAo,6502
+redundanet/cli/__init__.py,sha256=4XqFI3iyLQO6ko2bcSq_OoMvlrk8voMK8twcsHgUziY,89
+redundanet/cli/main.py,sha256=teFau_SP_rb5aDIBNH7vgwcOa8wjXoLW3SoL36kLQZ0,8129
+redundanet/cli/network.py,sha256=K5d03q4t3CBJXEreAQ8WFAsWv2qBhQUIfCE1_1lQcY4,5796
+redundanet/cli/node.py,sha256=z9JyrBdJfpqA7s65_TnyXI_70-7WpH1GlBhG13NfZyM,10161
+redundanet/cli/storage.py,sha256=I-n8NO_x_v7vKp3bx3yxfYNLNHNyOOuXMpl0T4mmZzs,8054
+redundanet/core/__init__.py,sha256=fOx3CxtyI4s2wPmBzAuqkcGq5JLKKS3BvebuUandNBQ,673
+redundanet/core/config.py,sha256=ZlEaR9i1aVHtnWcTE-BHvu3vwpYxd5q0rhlwT6hKh3g,6328
+redundanet/core/exceptions.py,sha256=sCeMw0YU7FFdpZkav5PW64-PTuGUPd2_7TaGlsJh9lY,1835
+redundanet/core/manifest.py,sha256=nW0BEtKEwlh5QQPUCeR8Anya1a8CWJ5-JwBYNW18JBA,12257
+redundanet/core/node.py,sha256=gMtsDVLz1gSZjttoU7jBUQfuQrHV3yDY2ts1yvZL780,4140
+redundanet/network/__init__.py,sha256=8t1sNA9P7xOC_IHN_Tbo0qFakQBTmrriuh-M2fzB41Y,286
+redundanet/network/discovery.py,sha256=37bu-EL5IKnYHxuup1wBJo3498q9stER-yRX3_6TKlk,6261
+redundanet/network/dns.py,sha256=CneCQldM_QmRaJQJKx3YjygRKktfLjT6y3qJFb48tVc,5305
+redundanet/network/validation.py,sha256=DhjnyknkiCd-FYDz30GcewYC-7lMZCfPGGrBm_DpnPg,8952
+redundanet/storage/__init__.py,sha256=a3e4hfWqY-Gczpi-aMlXEKgQIXAO67K5xc3uBn8I1bI,353
+redundanet/storage/client.py,sha256=FIrgpyZe2ovirvGApk73mtVycZDohuk6Dnnc0KxuCCo,9312
+redundanet/storage/furl.py,sha256=z5s_5344JN6lYRxdt35d7PFL0wtLvBaWdG3Pw4ztLbo,5560
+redundanet/storage/introducer.py,sha256=qhGI3lUOrxCYdx3anF8hFd5efSvDu_JKFPQFBcJI3yM,5483
+redundanet/storage/storage.py,sha256=eedGkr4nr6wUHf4UxMOiI9iyhcq-QEba9qLwEL7kJyY,6495
+redundanet/utils/__init__.py,sha256=gGWh6jgJZLZuRUBKXmIxbMMxsy0B6oU5p63UxUHFcO0,392
+redundanet/utils/files.py,sha256=Mo-_TevoDgVpYo_qMvSLx8CBYXWltz66AOMtIJM6sQA,3761
+redundanet/utils/logging.py,sha256=wvun1z7C2doOCDZHZGYLyW63h5V07TrfS9lH0nOeKOg,2779
+redundanet/utils/process.py,sha256=TZQO9bfwKYOu4OApBEFypiQLyWAenowIu-6HVREACw0,6157
+redundanet/vpn/__init__.py,sha256=MB3Bh4xrCCZUoj1d2BkfbbSbmwL7652lMO76Re6dEjk,283
+redundanet/vpn/keys.py,sha256=yTfLpqguTNOZlsvgzMS4vq9WTgVL9AUVTcZbftY6a3w,5326
+redundanet/vpn/mesh.py,sha256=EVdYcQY2reV_UESXRHEUKEIhhSSwaG7u1vvPtV6PDZI,6041
+redundanet/vpn/tinc.py,sha256=u5j2ZMPOjTfXM4LPHjg7NZmYdTF51kg58qTuA7CDtTw,10288
+redundanet-2.0.0.dist-info/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+redundanet-2.0.0.dist-info/METADATA,sha256=x9hHnnwtCPaRwVWw2bGB0SHyUFs2IK6A6huPCpVH7pc,7252
+redundanet-2.0.0.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
+redundanet-2.0.0.dist-info/entry_points.txt,sha256=-0cdQEyYsTHavFdq-k_uws2bxnQrD2Ud0FfllcHGrcw,54
+redundanet-2.0.0.dist-info/RECORD,,

redundanet-2.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 1.8.1
+Root-Is-Purelib: true
+Tag: py3-none-any

redundanet-2.0.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+redundanet=redundanet.cli.main:app
+