Skip to content
Content

Ice Breaker (TypeScript Edition)

image
January 25, 2025

Overview

The Ice Breaker (TypeScript Edition) project takes the original Python-based Ice Breaker application and reimagines it in a Node.js & TypeScript environment. Its primary goal is to crawl LinkedIn data using Scrapin.io and retrieve tweets from the Twitter API to generate personalized “ice breaker” messages for individuals. By combining professional data from LinkedIn and social insights from Twitter, users can craft messages that resonate with the interests and background of the recipient.

Key Features

  • TypeScript Backend
    A robust Node.js application built in TypeScript, providing type-safety and improved maintainability.
  • LinkedIn Data Crawling
    Utilizes Scrapin.io (paid API) to scrape pertinent professional details from LinkedIn profiles.
  • Twitter Data Integration
    Leverages the paid Twitter API to fetch relevant tweets, ensuring the generated messages have up-to-date social context.
  • LangChain-based Generation
    Employs LangChain for building advanced AI workflows, enabling natural language generation and conversation-like features.

Benefits

  1. Personalized Messaging
    By analyzing professional and social footprints, the app helps you quickly create messages that feel unique and relevant.
  2. Streamlined AI Workflow
    LangChain’s modular components make it easier to expand and customize the generative AI logic.
  3. Extendable Architecture
    Node.js + TypeScript stack simplifies integration with other services, databases, or additional AI features.

How It Works

  1. Prerequisites
    • Node.js 16+
    • Paid accounts (or free credits) with Scrapin.io and the Twitter Developer Platform
  2. Code Structure
    • src/
      • agents/
        • linkedinLookupAgent.ts
        • twitterLookupAgent.ts
      • templates/
        • index.html
      • third_parties/
        • linkedin.ts
        • twitter.ts
      • tools/
        • tools.ts
      • app.ts
      • ice-breaker.ts
      • outputParsers.ts
    • .env.example
    • package.json
    • tsconfig.json
  3. Installation & Execution
    • Clone and Install
Clone the repository
Navigate into the project directory
Install the dependencies
  • Set Environment Variables
    Copy the example file and add your credentials
Then update .env with your Scrapin.io and Twitter and other keys
  • Run the App
or

Final notes

This TypeScript rewrite brings improved maintainability and type safety to the original project. Contributions, suggestions, and feature requests are always welcome. To explore the project or contribute, visit the GitHub Repository. If you need more information or have additional questions, let me know!