Skip to main content

git # semantic-bit Package

This directory contains the Python package implementation of semantic-bit.

🚀 Quick Start - Gradio App

# From the project root (semantic_bit_theory/)

# 1. Activate virtual environment
source venv/bin/activate          # macOS/Linux
venv\Scripts\activate             # Windows

# 2. Run the app
cd semantic_bit
python -m demo.gradio_app

# Opens at: http://localhost:7860

Or use the convenience script:

./start_gradio.sh      # macOS/Linux
./start_gradio.bat       # Windows

Package Structure

semantic_bit/
├── src/semantic_bit/     # Source code
│   ├── __init__.py       # Package exports and API
│   ├── semantic.py       # Core SBT implementation  
│   ├── cli.py           # Command line interface
│   └── analyzer.py      # Legacy text analysis
├── tests/               # Test suite (62+ tests)
├── pyproject.toml       # Package configuration
└── pytest.ini          # Test configuration

Development

This package is part of the larger semantic_bit_theory project.

📖 For complete documentation, see the project README

Quick Development Setup

# From the project root (semantic_bit_theory/)
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install all development dependencies
pip install -r requirements.txt

# Install this package in editable mode
pip install -e ./semantic_bit

# Run tests
pytest semantic_bit/tests/

Note: The core semantic-bit package has zero runtime dependencies. Development dependencies (matplotlib, numpy, pytest) are only needed for working on the repository, not for using the published package.

Testing

# Run all tests
pytest

# Run specific test categories  
pytest tests/test_semantic.py::TestEncoding -v

📖 For detailed testing instructions, see Testing Guide

Gradio Visual Testing App

An interactive web interface for testing pattern detection, visualization, and SVG animation generation.

Setup

# From the project root (semantic_bit_theory/)

# 1. Create virtual environment with Python 3.13 or 3.12
#    (Python 3.14 has compatibility issues with some dependencies)
python3.13 -m venv venv

# 2. Activate the virtual environment
source venv/bin/activate  # On Windows: venv/Scripts/activate

# 3. Install Gradio and dependencies
pip install gradio graphviz

# 4. Install semantic_bit package in editable mode
pip install -e ./semantic_bit

Running the App

Option 1: With Activated Virtual Environment (Recommended)

# From the project root (semantic_bit_theory/)

# Activate the virtual environment first:
source venv/bin/activate          # macOS/Linux
# OR
venv/Scripts/activate             # Windows

# Then run the app (works from any directory):
cd semantic_bit
python -m demo.gradio_app

# When done, deactivate:
deactivate

Option 2: Direct Python Path (No activation needed)

# From the project root (semantic_bit_theory/)

# macOS/Linux:
./venv/bin/python semantic_bit/demo/gradio_app.py

# Windows:
venv/Scripts/python.exe semantic_bit/demo/gradio_app.py

Option 3: Convenience Script ⭐

# From the project root
./start_gradio.sh      # macOS/Linux
# OR
start_gradio.bat       # Windows

The app will open at: http://localhost:7860

Features

  • Interactive text processing: Enter text and see semantic patterns extracted
  • Graph visualization: Visual representation of semantic relationships
  • Pattern inspection: Color-coded pattern display
  • JSON output: View the raw Semantic Bit JSON structure
  • Enrichments: Link assets and functions to patterns (optional)
  • SVG Animation (NEW): Generate animated SVG slideshows from text

System Requirements

  • macOS: Requires system Graphviz for graph rendering

    brew install graphviz
    
  • Linux: Install via package manager

    sudo apt-get install graphviz  # Debian/Ubuntu
    sudo yum install graphviz      # Red Hat/CentOS
    

Troubleshooting

"Which virtual environment should I use?"

The project should have ONE virtual environment in the project root:

  • ✅ Use: /Users/.../semantic_bit_theory/venv/ (project root)
  • ❌ Don't use: .venv, semantic_bit/venv, or other locations

If you have multiple venv directories, remove the extras:

# From project root
rm -rf .venv semantic_bit/venv  # Remove any extras
# Keep only: venv/

"ModuleNotFoundError: No module named 'gradio'"

Your virtual environment isn't activated or dependencies aren't installed:

source venv/bin/activate          # Activate first
pip install gradio graphviz       # Install dependencies
pip install -e ./semantic_bit     # Install package

"python: command not found" (Windows)

Use python instead of python3:

python -m venv venv               # Create venv
venv\Scripts\activate             # Activate
python -m demo.gradio_app         # Run app

Package Development

Building and Publishing

# Install build tools (or use pip install -r requirements.txt from project root)
pip install build twine

# Build the package (from the semantic_bit/ directory)
python3.10 -m build

# Upload to PyPI
python3.10 -m twine upload dist/*

Note: A .pypirc file in your home directory is recommended for PyPI authentication. See the Twine documentation for details.

For complete project information, installation instructions, and usage examples, see the main project README.

Metadata

Release files for semantic-bit 1.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for semantic-bit 1.0.2
File Size Uploaded Provenance Actions
semantic_bit-1.0.2.tar.gz 40.2 kB Without provenance Details for semantic_bit-1.0.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for semantic-bit 1.0.2
File Interpreter ABI Platform Actions
semantic_bit-1.0.2-py3-none-any.whl Python 3 none any Details for semantic_bit-1.0.2-py3-none-any.whl

Total release size: 76.7 kB

Release files / semantic_bit-1.0.2.tar.gz

Download URL semantic_bit-1.0.2.tar.gz
Size 40.2 kB
Tags Source
SHA-256 checksum
How to use checksums
04ea1a4b77d78ca719c9d8e7ed6bc30818ee56efccd7da770cb2dd3e51ed7bd0
BLAKE2b-256 checksum
How to use checksums
076fb41c92f254b2aaee666c88c6d86254a1b8ae21cb30052391f64dcd567203
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.19

Release files / semantic_bit-1.0.2-py3-none-any.whl

Download URL semantic_bit-1.0.2-py3-none-any.whl
Size 36.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3fa440503164720544a0e7bee55c4b6456951d73a2a607f9d40bed21f5e85970
BLAKE2b-256 checksum
How to use checksums
9649b87ddd99a7732e0a7690cd7533045dd5297c122cc84b96866de2a295f572
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.19

Security for semantic-bit 1.0.2

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page