# njwacky/blaqvibe architecture

> Architecture diagram of the GitHub repository njwacky/blaqvibe, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/njwacky/blaqvibe
- Repository: https://github.com/njwacky/blaqvibe

## Overview

BlaqVibes is a creator network whose central workflow takes a creator from building and publishing a project through evidence-backed scanning, discovery, remixing and competition, toward capability-based opportunities. Its Django gallery and user apps hold the project and identity domain; Celery tasks handle asynchronous scan work. The README also describes Builder Skills, challenges, attention/inbox triage and GitHub import. Nolo is a companion terminal agent with a separate CLI and workspace-safety layer. Several product branches are documented but their implementation was not sampled, so those links are cited to the README rather than inferred from imports.

Main entry points: [`nolo-agent/src/cli.ts`](https://github.com/njwacky/blaqvibe/blob/master/nolo-agent/src/cli.ts) (Nolo CLI), [`gallery/models.py`](https://github.com/njwacky/blaqvibe/blob/master/gallery/models.py) (Project records), [`gallery/views.py`](https://github.com/njwacky/blaqvibe/blob/master/gallery/views.py) (Publish and import), [`gallery/tasks.py`](https://github.com/njwacky/blaqvibe/blob/master/gallery/tasks.py) (Scan and review)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_creation["Create and prove"]
  node_project[("Project records<br/>[models.py]")]
  node_publish["Publish and import<br/>[views.py]"]
  node_scan["Scan and review<br/>[tasks.py]"]
  node_trust["Trust evidence<br/>[trust.py]"]
end

subgraph group_community["Discover and compete"]
  node_feed["Project feed<br/>[views.py]"]
  node_remix["Remix lineage<br/>[models.py]"]
  node_challenges["Challenges and battles<br/>[challenges.py]"]
  node_attention["Attention cases<br/>[attention.py]"]
  node_inbox[("Notifications<br/>[notify.py]")]
end

subgraph group_capability["Skills and opportunity"]
  node_skills[("Builder Skills<br/>[skill_models.py]")]
  node_capability["Capability discovery<br/>[ability.py]"]
  node_opportunity["Opportunities<br/>[opportunity.py]"]
  node_identity[("Creator accounts<br/>[models.py]")]
end

subgraph group_agent["Nolo agent"]
  node_cli["Nolo CLI<br/>[cli.ts]"]
  node_agentcore["Agent runtime<br/>[agent.ts]"]
  node_guard["Workspace guard<br/>[guard.ts]"]
  node_config["Agent config<br/>[config.ts]"]
  node_session[("Session history<br/>[session.ts]")]
end

node_creator(("Creator"))
node_github{{"GitHub archive"}}

node_creator -->|"submits work"| node_publish
node_github -->|"imports archive"| node_publish
node_publish -.->|"saves project"| node_project
node_publish -->|"queues scan"| node_scan
node_scan -->|"assesses evidence"| node_trust
node_scan -.->|"updates status"| node_project
node_project -->|"published work appears"| node_feed
node_creator -->|"remixes projects"| node_remix
node_creator -->|"competes"| node_challenges
node_creator -->|"resolves cases"| node_attention
node_attention -->|"notifies creator"| node_inbox
node_creator -->|"learns from builds"| node_skills
node_project -->|"proves skills"| node_capability
node_capability -->|"supports discovery"| node_opportunity
node_identity -->|"matches people"| node_capability
node_cli -->|"loads settings"| node_config
node_cli -->|"configures safety"| node_guard
node_cli -->|"runs agent"| node_agentcore
node_cli -->|"saves messages"| node_session

click node_project "https://github.com/njwacky/blaqvibe/blob/master/gallery/models.py"
click node_publish "https://github.com/njwacky/blaqvibe/blob/master/gallery/views.py"
click node_scan "https://github.com/njwacky/blaqvibe/blob/master/gallery/tasks.py"
click node_trust "https://github.com/njwacky/blaqvibe/blob/master/gallery/trust.py"
click node_feed "https://github.com/njwacky/blaqvibe/blob/master/gallery/views.py"
click node_remix "https://github.com/njwacky/blaqvibe/blob/master/gallery/models.py"
click node_challenges "https://github.com/njwacky/blaqvibe/blob/master/gallery/challenges.py"
click node_attention "https://github.com/njwacky/blaqvibe/blob/master/gallery/attention.py"
click node_inbox "https://github.com/njwacky/blaqvibe/blob/master/gallery/notify.py"
click node_skills "https://github.com/njwacky/blaqvibe/blob/master/gallery/skill_models.py"
click node_capability "https://github.com/njwacky/blaqvibe/blob/master/gallery/ability.py"
click node_opportunity "https://github.com/njwacky/blaqvibe/blob/master/gallery/opportunity.py"
click node_identity "https://github.com/njwacky/blaqvibe/blob/master/users/models.py"
click node_cli "https://github.com/njwacky/blaqvibe/blob/master/nolo-agent/src/cli.ts"
click node_agentcore "https://github.com/njwacky/blaqvibe/blob/master/nolo-agent/src/agent.ts"
click node_guard "https://github.com/njwacky/blaqvibe/blob/master/nolo-agent/src/tools/guard.ts"
click node_config "https://github.com/njwacky/blaqvibe/blob/master/nolo-agent/src/config.ts"
click node_session "https://github.com/njwacky/blaqvibe/blob/master/nolo-agent/src/session.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_project,node_publish,node_scan,node_trust toneBlue
class node_feed,node_remix,node_challenges,node_attention,node_inbox toneAmber
class node_skills,node_capability,node_opportunity,node_identity toneMint
class node_cli,node_agentcore,node_guard,node_config,node_session toneRose
class node_creator,node_github toneIndigo
```

## Components

### Create and prove

- [Project records](https://github.com/njwacky/blaqvibe/blob/master/gallery/models.py): `gallery/models.py`
- [Publish and import](https://github.com/njwacky/blaqvibe/blob/master/gallery/views.py): `gallery/views.py`
- [Scan and review](https://github.com/njwacky/blaqvibe/blob/master/gallery/tasks.py): `gallery/tasks.py`
- [Trust evidence](https://github.com/njwacky/blaqvibe/blob/master/gallery/trust.py): `gallery/trust.py`

### Discover and compete

- [Project feed](https://github.com/njwacky/blaqvibe/blob/master/gallery/views.py): `gallery/views.py`
- [Remix lineage](https://github.com/njwacky/blaqvibe/blob/master/gallery/models.py): `gallery/models.py`
- [Challenges and battles](https://github.com/njwacky/blaqvibe/blob/master/gallery/challenges.py): `gallery/challenges.py`
- [Attention cases](https://github.com/njwacky/blaqvibe/blob/master/gallery/attention.py): `gallery/attention.py`
- [Notifications](https://github.com/njwacky/blaqvibe/blob/master/gallery/notify.py): `gallery/notify.py`

### Skills and opportunity

- [Builder Skills](https://github.com/njwacky/blaqvibe/blob/master/gallery/skill_models.py): `gallery/skill_models.py`
- [Capability discovery](https://github.com/njwacky/blaqvibe/blob/master/gallery/ability.py): `gallery/ability.py`
- [Opportunities](https://github.com/njwacky/blaqvibe/blob/master/gallery/opportunity.py): `gallery/opportunity.py`
- [Creator accounts](https://github.com/njwacky/blaqvibe/blob/master/users/models.py): `users/models.py`

### Nolo agent

- [Nolo CLI](https://github.com/njwacky/blaqvibe/blob/master/nolo-agent/src/cli.ts): `nolo-agent/src/cli.ts`
- [Agent runtime](https://github.com/njwacky/blaqvibe/blob/master/nolo-agent/src/agent.ts): `nolo-agent/src/agent.ts`
- [Workspace guard](https://github.com/njwacky/blaqvibe/blob/master/nolo-agent/src/tools/guard.ts): `nolo-agent/src/tools/guard.ts`
- [Agent config](https://github.com/njwacky/blaqvibe/blob/master/nolo-agent/src/config.ts): `nolo-agent/src/config.ts`
- [Session history](https://github.com/njwacky/blaqvibe/blob/master/nolo-agent/src/session.ts): `nolo-agent/src/session.ts`

### Other components

- **Creator**
- **GitHub archive**

## Connections

- Creator → Publish and import: submits work
- GitHub archive → Publish and import: imports archive
- Publish and import → Project records: saves project
- Publish and import → Scan and review: queues scan
- Scan and review → Trust evidence: assesses evidence (evidence: `gallery/tasks.py`)
- Scan and review → Project records: updates status (evidence: `gallery/tasks.py`)
- Project records → Project feed: published work appears
- Creator → Remix lineage: remixes projects
- Creator → Challenges and battles: competes
- Creator → Attention cases: resolves cases
- Attention cases → Notifications: notifies creator
- Creator → Builder Skills: learns from builds
- Project records → Capability discovery: proves skills
- Capability discovery → Opportunities: supports discovery
- Creator accounts → Capability discovery: matches people
- Nolo CLI → Agent config: loads settings (evidence: `nolo-agent/src/cli.ts`)
- Nolo CLI → Workspace guard: configures safety (evidence: `nolo-agent/src/cli.ts`)
- Nolo CLI → Agent runtime: runs agent (evidence: `nolo-agent/src/cli.ts`)
- Nolo CLI → Session history: saves messages (evidence: `nolo-agent/src/cli.ts`)
