Code Projects

APIs, SDKs, libraries, and applications for Wardley Mapping.


Table of contents

  1. Core Libraries and SDKs
    1. Wardley Map Mathematical Model
    2. Wardley Mapping Python Module (Beta)
    3. Wardley Map Library
    4. Wardley Maps Graphs
    5. Wardley Mapping Crew TypeScript SDK [Prototype]
    6. Wardley Mapping Crew Python SDK [Prototype]
    7. Update wardleymap Python package for OWM v2
  2. APIs
    1. Wardley Mapping Crew API (Alpha)
    2. Videos API (Alpha)
    3. Analyse Wardley Map Images API (Alpha)
    4. API for querying the Wardley Mapping book (Alpha)
    5. API for querying Wardley Mapping videos (Alpha)
  3. AI and Voice Assistants
    1. TiM (Think-in-Memory) Demo Application
    2. Live Audio Wardley AI Crew Assistant Server [Prototype]
    3. Live Wardley Voice Assistant (MVP)
  4. Content Generation
    1. DeepBook - Generate a book about anything using GenAI
    2. Create a book on Wardley Mapping using GenAI
    3. Automatically Generate a Book Based on a 1 Line Prompt
    4. YouTube Script Generation
    5. Lesson Plan Generation
    6. Presentation Generation
    7. Document Creator - Automated Creation of Reports
  5. In Progress Projects
    1. Create a course on Wardley Mapping using GenAI
    2. Integrate Zuplo/Clerk/OpenAI GPTs
    3. Update all Wardley Mapping chatbots
  6. Todo Projects
    1. NEXT.JS Frontend for Live Wardley AI Crew Assistants
  7. Other Code Projects
    1. OnlineWardleyMaps - Updated to leverage LLMs
    2. New Embeddings - Wardley Map Images

Core Libraries and SDKs

Wardley Map Mathematical Model

   
Status Done
Date 2024-12-25
Link GitHub

Research and theoretical frameworks for formalising Wardley Mapping as a mathematical model. Transforms maps from qualitative visual tools into quantitative frameworks enabling computation, simulation, and data-driven strategic decision-making.

Key features:

  • Formal tuple model: $\mathcal{M} = (V, E, u, \nu, \varepsilon, t)$
  • Computed visibility and evolution scoring
  • S-curve evolution dynamics
  • Decision metrics (differentiation pressure, commodity leverage, dependency risk)
  • Game-theoretic extensions
  • AI prompts for map generation

Documentation includes: 5-part progressive series, strategy cycle models, weak signal detection, and gameplay quantification.


Wardley Mapping Python Module (Beta)

   
Status Done
Dates 2024-02-12 to 2024-02-18
Link PyPI

WardleyMap is a Python package designed for creating and visualizing Wardley Maps. Features include:

  • Parse and interpret Wardley Map syntax
  • Visualise maps using matplotlib
  • Export maps to SVG format
  • Utilities to convert Wardley Map text into JSON, TOML, GRAPH and Cypher Text

Wardley Map Library

   
Status Done
Date 2025-05-24

Creation of a Streamlit app to display the automatically created books.


Wardley Maps Graphs

   
Status Done
Date 2025-05-25

Create a Streamlit application to turn any document into a graph.


Wardley Mapping Crew TypeScript SDK [Prototype]

   
Status Done
Dates 2024-06-17 to 2024-06-30
Link GitHub

Alpha TypeScript client SDK for accessing the Wardley Mapping Crew API.


Wardley Mapping Crew Python SDK [Prototype]

   
Status Done
Dates 2024-06-17 to 2024-06-30
Link GitHub

Alpha Python client SDK for accessing the Wardley Mapping Crew API.


Update wardleymap Python package for OWM v2

   
Status Done
Dates 2024-07-06 to 2024-08-31

Major update to the wardleymap Python package adding support for Open Wardley Maps (OWM) v2 specification. Includes enhanced parsing for new syntax elements, improved component positioning, and better interoperability with the OWM ecosystem.


APIs

Wardley Mapping Crew API (Alpha)

   
Status Done
Dates 2024-02-26 to 2024-03-03

RESTful API providing programmatic access to Wardley Mapping resources, including map generation, component analysis, and strategic pattern detection. Enables developers to integrate Wardley Mapping capabilities into their own applications and workflows.


Videos API (Alpha)

   
Status Done
Date 2024-06-08

API endpoint for accessing and querying the indexed Wardley Mapping video content. Returns video metadata, transcripts, and relevant timestamps based on semantic search queries about Wardley Mapping concepts.


Analyse Wardley Map Images API (Alpha)

   
Status Done
Dates 2024-06-15 to 2024-06-28

Computer vision API that analyses uploaded Wardley Map images using multimodal AI. Extracts components, dependencies, and evolution positions from hand-drawn or digital maps, converting visual representations into structured data.


API for querying the Wardley Mapping book (Alpha)

   
Status Done
Dates 2024-06-10 to 2024-06-16

Semantic search API powered by vector embeddings of Simon Wardley’s book content. Enables natural language queries against the book’s chapters, returning contextually relevant passages with source citations and page references.


API for querying Wardley Mapping videos (Alpha)

   
Status Done
Date 2024-06-18

Vector-based search API for querying transcribed Wardley Mapping video content. Supports semantic search across hundreds of hours of video content, returning relevant segments with timestamps and speaker attribution.


AI and Voice Assistants

TiM (Think-in-Memory) Demo Application

   
Status Done
Date 2025-05-26

Simplified demonstration of the Think-in-Memory (TiM) framework for LLMs with long-term memory. Features:

  • Inductive Thought Storage
  • Simplified Locality-Sensitive Hashing (LSH)
  • Recall and Post-thinking stages
  • Memory Organization Operations (Insert, Forget, Merge)

Live Audio Wardley AI Crew Assistant Server [Prototype]

   
Status Done
Dates 2024-06-22 to 2024-08-31

Real-time audio streaming server enabling voice-based interactions with the Wardley Mapping AI assistant. Implements WebSocket connections for bidirectional audio, speech-to-text processing, and text-to-speech response generation for hands-free strategic consulting.


Live Wardley Voice Assistant (MVP)

   
Status Done
Dates 2024-07-03 to 2024-07-05

Minimum viable product for voice-activated Wardley Mapping assistance. Users can ask questions about Wardley Maps, strategic concepts, and mapping techniques using natural speech, receiving audio responses powered by LLM integration with the Wardley Mapping knowledge base.


Content Generation

DeepBook - Generate a book about anything using GenAI

   
Status MAPS: Continuous Improvement
Date 2024-12-07 onwards

Advanced generative AI system for creating comprehensive, structured books on any topic. Uses multi-agent workflows to research, outline, draft, and refine chapters with consistent voice and style. Supports various output formats including Markdown, PDF, and EPUB.


Create a book on Wardley Mapping using GenAI

   
Status Done
Dates 2024-08-01 to 2024-08-17

Automated book generation system specifically trained on Wardley Mapping concepts. Produces structured educational content covering fundamentals, advanced techniques, case studies, and strategic applications. Used to generate the AI-created book series on Wardley Mapping topics.


Automatically Generate a Book Based on a 1 Line Prompt

   
Status Done
Dates 2024-08-02 to 2024-08-26

One-shot book generation tool that transforms a single-line topic description into a complete manuscript. Utilises iterative chapter generation with coherence checking, table of contents creation, and cross-reference linking to produce publication-ready content.


YouTube Script Generation

   
Status Done
Date 2024-08-25

AI-powered script generator for YouTube video content about Wardley Mapping. Creates engaging scripts with hooks, transitions, visual cues, and call-to-actions optimised for video format. Includes timing estimates and B-roll suggestions.


Lesson Plan Generation

   
Status Done
Date 2024-08-25

Educational content generator that creates structured lesson plans for teaching Wardley Mapping. Produces learning objectives, activities, assessments, and supplementary materials aligned with instructional design best practices.


Presentation Generation

   
Status Done
Date 2024-08-25

Automated slide deck generator for Wardley Mapping presentations. Creates visually structured presentations with speaker notes, key talking points, and embedded map visualisations suitable for workshops, conferences, and training sessions.


Document Creator - Automated Creation of Reports

   
Status Done
Dates 2023-12-19 to 2024-01-31

Automated report generation system that produces strategic analysis documents using Wardley Mapping principles. Generates executive summaries, detailed analyses, recommendations, and supporting appendices in professional document formats.


In Progress Projects

Create a course on Wardley Mapping using GenAI

   
Status In progress
Dates 2024-08-08 to 2024-08-24

Comprehensive online course generation using AI to create modules, quizzes, assignments, and interactive exercises for learning Wardley Mapping. Includes video script generation, assessment rubrics, and progressive learning paths from beginner to advanced levels.


Integrate Zuplo/Clerk/OpenAI GPTs

   
Status In progress
Dates 2024-07-07 to 2024-08-31

Enable authentication with the OpenAI GPT APIs. This will enable a unique identifier to be passed to the APIs for memory/user features.


Update all Wardley Mapping chatbots

   
Status In progress
Dates 2024-10-01 to 2024-10-31

Update chatbots with latest versions of LangChain, OpenAI, Anthropic, Pinecone, and Streamlit.


Todo Projects

NEXT.JS Frontend for Live Wardley AI Crew Assistants

   
Status Todo
Dates 2024-10-01 to 2024-10-31

Modern React-based frontend using Next.js for the Wardley AI Crew assistants. Planned features include real-time map visualisation, voice interaction interface, conversation history, and responsive design for desktop and mobile access to AI-powered strategic consulting.


Other Code Projects

OnlineWardleyMaps - Updated to leverage LLMs

   
Status Done
Dates 2023-09-01 to 2023-09-15

Fork onlinewardleymaps.com and create a version that can leverage LLMs.


New Embeddings - Wardley Map Images

   
Status Done
Dates 2024-06-18 to 2024-06-22

Create a new Pinecone embeddings vectorstore of all the images from the Wardley Mapping book.


Back to top

Wardley Mapping Resources - Created by Mark Craddock

This site uses Just the Docs, a documentation theme for Jekyll.