▶️ Qompass AI Network QuickStart
** Recommend to read the script in scripts/nix.sh FIRST and THEN copy and paste the below**
git clone https://github.com/qompassai/network.git
cd network
chmod +x scripts/nix.sh
./scripts/nix.shThe script automatically:
- ✅ Installs Nix (if not already installed)
- ✅ Enables flakes and experimental features
- ✅ Configures optimal settings (caching, substituters, etc.)
- ✅ Tests all tools to verify everything works
- ✅ Drops you into the development environment
rage- Modern file encryptionage- Original age encryptionopenssl- Cryptography toolkit
hash-utils blake3 <file>- BLAKE3 hashinghash-utils sha3-256 <file>- SHA3-256 hashing-
hash-utils sha512 <file>- SHA-512 hashingnetworkmanager- Network managementunbound- Secure DNSnmap- Network scanningtcpdump- Network analysis
nix build .#hash-utils ./result/bin/hash-utils blake3 somefile.txtBuild network setup script
nix build .#networkmanager-setup ./result/bin/networkmanager-setupRun tools directly from GitHub
nix run github:qompassai/network#hash-utils blake3 myfile.txtcd /path/to/qompassai/network nix develop
Generate a key and encrypt
rage-keygen -o mykey.txt rage -e -i mykey.txt -o secret.age plaintext.txt** The tools here are presented for educational purposes ONLY. Have Fun and be safe!
-
▶️ Qompass AI Quick Start
```bash
bash <(curl -L https://raw.githubusercontent.com/qompassai/dotfiles/main/scripts/quickstart.sh) ``` </div>
<blockquote
style="font-size: 1.2em; line-height: 1.8; padding: 25px; background: #f8f9fa; border-left: 6px solid #667eea; border-radius: 8px; margin: 15px 0; box-shadow: 0 2px 8px rgba(0,0,0,0.1);">
<details>
<summary
style="font-size: 1em; font-weight: bold; padding: 10px; background: #e9ecef; color: #333; border-radius: 5px; cursor: pointer; margin: 10px 0;">
<strong>📄 We advise you read the script BEFORE running it 😉</strong>
</summary>
<pre style="background: #fff; padding: 15px; border-radius: 5px; border: 1px solid #ddd; overflow-x: auto;">
#!/usr/bin/env bash
# /qompassai/dotfiles/scripts/quickstart.sh
# Qompass AI Quick Start Script
# Copyright (C) 2025 Qompass AI, All rights reserved
####################################################
REPO="https://github.com/qompassai/dotfiles"
TARGET_DIR="$HOME/.dotfiles"
if [ -d "$TARGET_DIR" ]; then
echo "Removing existing dotfiles directory..."
rm -rf "$TARGET_DIR"
fi
echo "Cloning Qompass AI Dotfiles..."
git clone "$REPO" "$TARGET_DIR"
echo "Setting up symlinks..."
mkdir -p "$HOME/.config/nix" "$HOME/.profile.d"
ln -sf "$TARGET_DIR/.config/nix/nix.conf" "$HOME/.config/nix/nix.conf"
ln -sf "$TARGET_DIR/.profile.d/67-nix.sh" "$HOME/.profile.d/67-nix.sh"
mkdir -p "$HOME/.config"
ln -sfn "$TARGET_DIR/home" "$HOME/.config/home" 2>/dev/null || true
ln -sfn "$TARGET_DIR/.local" "$HOME/.local" 2>/dev/null || true
ln -sf "$TARGET_DIR/flake.nix" "$HOME/.config/flake.nix" 2>/dev/null || true
source "$HOME/.profile.d/67-nix.sh" 2>/dev/null || {
echo "WARNING: Could not source Nix profile configuration. Falling back to manual exporting"
export NIX_CONF_DIR="$HOME/.config/nix"
export NIX_STORE_DIR="$HOME/.nix/store"
export NIX_STATE_DIR="$HOME/.local/state/nix"
export NIX_LOG_DIR="$HOME/.local/state/nix/log"
export NIX_PROFILE_DIR="$HOME/.nix-profile"
export PATH="$NIX_PROFILE_DIR/bin:$PATH"
}
if ! command -v nix >/dev/null; then
echo "Installing Nix with custom configuration..."
mkdir -p /.nix/var/nix/{profiles,gcroots,db}
chown -R "$(whoami)" /.nix
sh <(curl -L https://nixos.org/nix/install) --daemon \ --nix-extra-conf-file "$NIX_CONF_DIR/nix.conf" if [
-f '/.nix/var/nix/profiles/default/etc/profile.d/nix-daemon.sh' ]; then
. '/.nix/var/nix/profiles/default/etc/profile.d/nix-daemon.sh' fi fi echo "Setting up Nix environment..."
cd "$TARGET_DIR" nix flake update detect_shell() { case "$(ps -p $$ -o comm=)" in *bash*) echo "bash" ;;
*zsh*) echo "zsh" ;; *fish*) echo "fish" ;; *) echo "bash" ;; esac } USER_SHELL=$(detect_shell)
echo "Detected shell: $USER_SHELL" nix develop --command "$USER_SHELL" </pre>
</details>
<p>Or, <a href="https://github.com/qompassai/dotfiles/blob/main/scripts/quickstart.sh" target="_blank">View the
quickstart script</a>.</p>
</blockquote>
🧭 About Qompass AI
<div align="center"> <p>Matthew A. Porter<br> Former Intelligence Officer<br> Educator & Learner<br> DeepTech Founder & CEO</p> </div> <h3>Publications</h3> <p> <a href="https://orcid.org/0000-0002-0302-4812"> <img src="https://img.shields.io/badge/ORCID-0000--0002--0302--4812-green?style=flat-square&logo=orcid" alt="ORCID"> </a> <a href="https://www.researchgate.net/profile/Matt-Porter-7"> <img src="https://img.shields.io/badge/ResearchGate-Open--Research-blue?style=flat-square&logo=researchgate" alt="ResearchGate"> </a> <a href="https://zenodo.org/communities/qompassai"> <img src="https://img.shields.io/badge/Zenodo-Publications-blue?style=flat-square&logo=zenodo" alt="Zenodo"> </a> </p> <h3>Developer Programs</h3> [](https://developer.nvidia.com/) [](https://developers.facebook.com/) [](https://hackerone.com/phaedrusflow) [](https://huggingface.co/qompass) [](https://dev.epicgames.com/) <h3>Professional Profiles</h3> <p> <a href="https://www.linkedin.com/in/matt-a-porter-103535224/"> <img src="https://img.shields.io/badge/LinkedIn-Matt--Porter-blue?style=flat-square&logo=linkedin" alt="Personal LinkedIn"> </a> <a href="https://www.linkedin.com/company/95058568/"> <img src="https://img.shields.io/badge/LinkedIn-Qompass--AI-blue?style=flat-square&logo=linkedin" alt="Startup LinkedIn"> </a> </p> <h3>Social Media</h3> <p> <a href="https://twitter.com/PhaedrusFlow"> <img src="https://img.shields.io/badge/Twitter-@PhaedrusFlow-blue?style=flat-square&logo=twitter" alt="X/Twitter"> </a> <a href="https://www.instagram.com/phaedrusflow"> <img src="https://img.shields.io/badge/Instagram-phaedrusflow-purple?style=flat-square&logo=instagram" alt="Instagram"> </a> <a href="https://www.youtube.com/@qompassai"> <img src="https://img.shields.io/badge/YouTube-QompassAI-red?style=flat-square&logo=youtube" alt="Qompass AI YouTube"> </a> </p>
🔥 How Do I Support
<div align="center"> <table> <tr> <th align="center">🏛️ Qompass AI Pre-Seed Funding 2023-2025</th> <th align="center">🏆 Amount</th> <th align="center">📅 Date</th> </tr> <tr> <td><a href="https://github.com/qompassai/r4r" title="RJOS/Zimmer Biomet Research Grant Repository">RJOS/Zimmer Biomet Research Grant</a></td> <td align="center">$30,000</td> <td align="center">March 2024</td> </tr> <tr> <td><a href="https://github.com/qompassai/PathFinders" title="GitHub Repository">Pathfinders Intern Program</a><br> <small><a href="https://www.linkedin.com/posts/evergreenbio_bioscience-internships-workforcedevelopment-activity-7253166461416812544-uWUM/" target="_blank">View on LinkedIn</a></small> </td> <td align="center">$2,000</td> <td align="center">October 2024</td> </tr> </table> <br> <h4>🤝 How To Support Our Mission</h4> [](https://github.com/sponsors/phaedrusflow) [](https://patreon.com/qompassai) [](https://liberapay.com/qompassai) [](https://opencollective.com/qompassai) [](https://www.buymeacoffee.com/phaedrusflow) <details markdown="1"> <summary><strong>🔐 Cryptocurrency Donations</strong></summary> **Monero (XMR):** <div align="center"> <img src="./assets/monero-qr.png" alt="Monero QR Code" width="180"> </div> <div style="margin: 10px 0;"> <code>42HGspSFJQ4MjM5ZusAiKZj9JZWhfNgVraKb1eGCsHoC6QJqpo2ERCBZDhhKfByVjECernQ6KeZwFcnq8hVwTTnD8v4PzyH</code> </div> <button onclick="navigator.clipboard.writeText('42HGspSFJQ4MjM5ZusAiKZj9JZWhfNgVraKb1eGCsHoC6QJqpo2ERCBZDhhKfByVjECernQ6KeZwFcnq8hVwTTnD8v4PzyH')" style="padding: 6px 12px; background: #FF6600; color: white; border: none; border-radius: 4px; cursor: pointer;"> 📋 Copy Address </button> <p><i>Funding helps us continue our research at the intersection of AI, healthcare, and education</i></p>
Frequently Asked Questions
Q: How do you mitigate against bias?
TLDR - we do math to make AI ethically useful
A: We delineate between mathematical bias (MB) - a fundamental parameter in neural network equations - and
algorithmic/social bias (ASB). While MB is optimized during model training through backpropagation, ASB requires careful consideration of data sources, model architecture, and deployment strategies. We implement attention mechanisms for improved input processing and use legal open-source data and secure web-search APIs to help mitigate ASB.
AAMC AI Guidelines | One way to align AI against ASB
AI Math at a glance
Forward Propagation Algorithm
$$ y = w_1x_1 + w_2x_2 + ... + w_nx_n + b $$
Where:
-
$y$ represents the model output -
$(x_1, x_2, ..., x_n)$ are input features -
$(w_1, w_2, ..., w_n)$ are feature weights -
$b$ is the bias term
Neural Network Activation
For neural networks, the bias term is incorporated before activation:
$$ z = \sum_{i=1}^{n} w_ix_i + b $$ $$ a = \sigma(z) $$
Where:
-
$z$ is the weighted sum plus bias -
$a$ is the activation output -
$\sigma$ is the activation function
Attention Mechanism- aka what makes the Transformer (The "T" in ChatGPT) powerful
The Attention mechanism equation is:
$$ \text{Attention}(Q, K, V) = \text{softmax}\left( \frac{QK^T}{\sqrt{d_k}} \right) V $$
Where:
-
$Q$ represents the Query matrix -
$K$ represents the Key matrix -
$V$ represents the Value matrix -
$d_k$ is the dimension of the key vectors -
$\text{softmax}(\cdot)$ normalizes scores to sum to 1
Q: Do I have to buy a Linux computer to use this? I don't have time for that!
A: No. You can run Linux and/or the tools we share alongside your existing operating system:
- Windows users can use Windows Subsystem for Linux WSL
- Mac users can use Homebrew
- The code-base instructions were developed with both beginners and advanced users in mind.
Q: Do you have to get a masters in AI?
A: Not if you don't want to. To get competent enough to get past ChatGPT dependence at least, you just need
a computer and a beginning's mindset. Huggingface is a good place to start.
Q: What makes a "small" AI model?
A: AI models ~=10 billion(10B) parameters and below. For comparison, OpenAI's GPT4o contains approximately
200B parameters.
This project is licensed under the Apache License, Version 2.0.