Lamaste Prep

Prerequisites installer for the Lamaste platform on Ubuntu, with integrated GitHub repository setup.

Description

Lamaste Prep is an npm package that automatically installs all necessary prerequisites for the Lamaste platform on Ubuntu systems. It handles the installation of essential development tools and dependencies, and optionally helps you set up your GitHub repository.

Prerequisites Installed

• Git - Version control system
• curl - Command line tool for transferring data
• wget - Network downloader
• build-essential - Compilation tools (gcc, g++, make)

Requirements

• Ubuntu Linux (tested on Ubuntu 20.04+)
• Node.js >= 12.0.0
• sudo privileges for system package installation

Installation

Global Installation (Recommended)

npm install -g lamaste-prep

Local Installation

npm install lamaste-prep

Usage

After Global Installation

# Install prerequisites and optionally set up repository
lamaste-prep

# Set up GitHub repository separately
lamaste-setup-repo

Using npx (without installation)

npx lamaste-prep

Local Usage

npm start

GitHub Repository Setup

After installing prerequisites, Lamaste Prep will offer to help you set up a GitHub repository. This feature:

• Prompts for your GitHub Personal Access Token (with option to save securely)
• Lists all your accessible repositories
• Allows you to select and clone a repository
• Provides next-step suggestions based on the project type

To use repository setup separately:

lamaste-setup-repo

GitHub Token

The tool requires a GitHub Personal Access Token with:

• repo scope for private repositories
• public_repo scope for public repositories only

Create a token at: https://github.com/settings/tokens

Tokens are saved securely in ~/.lamaste/github-token with 600 permissions.

What It Does

1. Updates Ubuntu package lists
2. Installs Git for version control
3. Installs curl for data transfer
4. Installs wget for downloading files
5. Installs build-essential (gcc, g++, make) for compilation
6. Verifies all installations and reports the status

Development

Publishing

To publish a new version to npm:

# Interactive publish script with version bumping
./publish.sh

# Or use npm scripts
npm run publish:patch  # 1.0.0 -> 1.0.1
npm run publish:minor  # 1.0.0 -> 1.1.0
npm run publish:major  # 1.0.0 -> 2.0.0

Pre-publish Checks

Run pre-publish checks manually:

node pre-publish-check.js

License

MIT

Support

For issues or questions about Lamaste Prep, please visit the Lamaste platform documentation.