VibeDNA
Where Digital Meets Biological
VibeDNA is a comprehensive binary-to-DNA and DNA-to-binary encoding system that enables computation and file management using DNA sequences as the storage and processing medium.
Features
-
Multi-Scheme Encoding: Support for 4 encoding schemes optimized for different use cases
- Quaternary: Standard 2-bit per nucleotide (highest density)
- Balanced GC: Maintains 40-60% GC content for synthesis compatibility
- Run-Length Limited (RLL): Prevents homopolymer runs for sequencing accuracy
- Redundant Triplet: 3x redundancy for maximum error tolerance
-
Error Correction: Reed-Solomon error correction adapted for GF(4) arithmetic
- Corrects up to 8 nucleotide errors per block
- Automatic error detection and correction
- Configurable redundancy levels
-
DNA Computation: Perform computations directly on DNA-encoded data
- Logic gates: AND, OR, XOR, NOT, NAND, NOR, XNOR
- Arithmetic: Addition, subtraction, multiplication, division
- Comparison and bitwise shift operations
-
DNA File System: Virtual file system with DNA sequence storage
- Full CRUD operations
- Hierarchical directory structure
- Search and indexing capabilities
-
CLI & REST API: Multiple interfaces for integration
- Feature-rich command-line interface
- RESTful API with OpenAPI documentation
Installation
From PyPI (Recommended)
# Install from PyPI
pip install vibedna
# Verify installation
vibedna --version
From Source
# Clone the repository
git clone https://github.com/ttracx/VibeDNA.git
cd VibeDNA
# Install with pip
pip install .
# Or install in development mode
pip install -e .
# Or install with development dependencies
pip install -e ".[dev]"
Requirements
- Python 3.10 or higher
- pip 21.0 or higher (for PEP 517 support)
Quick Start
Command Line
# Encode a file to DNA
vibedna encode document.pdf -o document.dna
# Decode back to original
vibedna decode document.dna -o recovered.pdf
# Quick text encoding (no headers)
vibedna quick "Hello, DNA World!"
# Perform DNA computation
vibedna compute gate XOR ATCG GCTA
# Store file in DNA file system
vibedna fs cp ./report.docx /documents/report.docx
Python SDK
from vibedna import DNAEncoder, DNADecoder, DNAFileSystem
# Encode data
encoder = DNAEncoder()
dna_sequence = encoder.encode(b"Hello World", filename="hello.txt")
print(f"Encoded: {dna_sequence[:50]}...")
# Decode back
decoder = DNADecoder()
result = decoder.decode(dna_sequence)
print(f"Decoded: {result.data}")
print(f"Filename: {result.filename}")
# File system operations
fs = DNAFileSystem()
fs.create_file("/hello.txt", b"Hello DNA!")
data = fs.read_file("/hello.txt")
print(f"Read from DNA FS: {data}")
REST API
# Start the API server
uvicorn vibedna.api.rest_server:app --host 0.0.0.0 --port 8000
# Encode data
curl -X POST "http://localhost:8000/encode" \
-H "Content-Type: application/json" \
-d '{"data": "SGVsbG8gV29ybGQh", "filename": "hello.txt"}'
# Quick encode text
curl -X POST "http://localhost:8000/quick/encode" \
-H "Content-Type: application/json" \
-d '{"text": "Hello World"}'
Encoding Specification
Primary Mapping (Quaternary)
| Binary | DNA |
|---|---|
| 00 | A (Adenine) |
| 01 | T (Thymine) |
| 10 | C (Cytosine) |
| 11 | G (Guanine) |
DNA Sequence Structure
┌─────────────────────────────────────────────────────────────────┐
│ DNA FILE FORMAT │
├─────────────────────────────────────────────────────────────────┤
│ HEADER (256 nucleotides) │
│ ├── Magic: ATCGATCG (8 nt) │
│ ├── Version: 4 nt │
│ ├── Scheme: 4 nt │
│ ├── File Size: 32 nt │
│ ├── Filename: 128 nt │
│ ├── MIME Type: 32 nt │
│ ├── Checksum: 32 nt │
│ └── Reserved: 16 nt │
├─────────────────────────────────────────────────────────────────┤
│ DATA BLOCKS (Variable) │
│ ├── Block Header: 16 nt per block │
│ └── Block Data: 1024 nt per block │
├─────────────────────────────────────────────────────────────────┤
│ ERROR CORRECTION │
│ └── Reed-Solomon Parity: 64 nt per block │
├─────────────────────────────────────────────────────────────────┤
│ FOOTER (32 nucleotides) │
│ ├── End Marker: GCTAGCTA (8 nt) │
│ ├── Block Count: 8 nt │
│ └── Checksum: 16 nt │
└─────────────────────────────────────────────────────────────────┘
Project Structure
vibedna/
├── core/ # Encoding/decoding engines
├── storage/ # DNA file system
├── error_correction/ # Reed-Solomon, Hamming codes
├── compute/ # DNA logic gates and arithmetic
├── cli/ # Command-line interface
├── api/ # REST API
├── utils/ # Utilities and constants
└── tests/ # Test suite
API Documentation
Full API documentation is available at /docs when running the API server.
Key endpoints:
POST /encode- Encode data to DNAPOST /decode- Decode DNA to dataPOST /compute- Perform DNA computationsGET /fs/list- List files in DNA storagePOST /fs/store- Store file in DNA storage
Docker
# Build the image
docker build -t vibedna .
# Run the API server
docker run -p 8000:8000 vibedna
Testing
# Run all tests
pytest
# Run with coverage
pytest --cov=vibedna
# Run specific test file
pytest tests/unit/test_encoder.py
Encoding Scheme Comparison
| Scheme | Bits/nt | GC Balanced | Homopolymer Safe | Error Tolerance |
|---|---|---|---|---|
| Quaternary | 2.0 | No | No | None |
| Balanced GC | 2.0 | Yes | No | None |
| RLL | ~1.8 | No | Yes | None |
| Triplet | 0.33 | No | No | High |
Performance
- Encoding: ~200 KB/s (quaternary scheme)
- Decoding: ~250 KB/s
- Error correction: Up to 8 errors per 1024 nucleotides
Contributing
This is proprietary software. Please contact NeuralQuantum.ai for licensing information.
License
Proprietary - All Rights Reserved
Support
For support and inquiries:
- Website: https://vibecaas.com
- Email: contact@neuralquantum.ai
© 2026 VibeDNA powered by VibeCaaS.com a division of NeuralQuantum.ai LLC. All rights reserved.
Metadata
Release files for vibedna 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| vibedna-1.0.0.tar.gz | 2.4 MB | Without provenance | Details for vibedna-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| vibedna-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for vibedna-1.0.0-py3-none-any.whl |
Total release size: 2.6 MB
Release files / vibedna-1.0.0.tar.gz
| Download URL | vibedna-1.0.0.tar.gz |
|---|---|
| Size | 2.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4f46a518cc114b02d88b1094ffd944e68db606238ad970f024225e5bde451530
|
|
BLAKE2b-256 checksum How to use checksums |
8f4e1e3e287d76c6f941df838ae661b6dae9c1c5a3e3e3394974a6028a43e992
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.10.14
|
Release files / vibedna-1.0.0-py3-none-any.whl
| Download URL | vibedna-1.0.0-py3-none-any.whl |
|---|---|
| Size | 181.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
66c0f5f8fb8a840fd6414e86e701abe6856f92b415d5d715e7b4d748b412eec8
|
|
BLAKE2b-256 checksum How to use checksums |
b224ec01d86d81ab3fdd951c032a94997998364b7061e8e35d0f34942302af4a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.10.14
|
Security for vibedna 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.