Coder Social home page Coder Social logo

codelumia's Introduction

title emoji colorFrom colorTo sdk app_port app_file pinned license
CodeLumia
📚
purple
blue
docker
8501
app.py
false
mit


CodeLumia

~Learn to Code, Step by Step~

Hugging Face SpacesGitHub Release

🚀 はじめに

CodeLumiaへようこそ!CodeLumiaは、GitHubリポジトリのソースコードを分析し、包括的なマークダウン形式のドキュメントを自動生成するツールです。プロジェクトの構造、依存関係、設定などを簡単に理解できるようになります。

CodeLumiaは、開発者がコードベースをすばやく把握し、プロジェクトに効率的に貢献できるようにすることを目的としています。新しいチームメンバーのオンボーディングを容易にし、コードの保守性を向上させます。

Tip

このリポジトリはSourceSageを活用しており、リリースノートやREADME、コミットメッセージの9割はSourceSageclaude.aiで生成しています。

主な特徴:

  • GitHubリポジトリの自動分析
  • マークダウン形式のドキュメント生成
  • ファイルとディレクトリの無視パターンのカスタマイズ
  • わかりやすいStreamlitユーザーインターフェース

CodeLumiaを使用して、プロジェクトのドキュメンテーションを強化し、チームのコラボレーションを促進しましょう。ぜひお試しください!

デモアプリ

Hugging Face Spaces

更新履歴

  • プレビュー機能の追加(ファイルツリー、マークダウン、プレーンテキスト)
  • リポジトリのスキャンとマークダウンファイルの生成機能を強化
  • ドキュメンテーションの改善とコードの可読性向上
  • ファイル操作とGit操作のモジュールを改善
  • アプリケーションの機能強化とドキュメントデザインの更新
  • デモGIFの更新
  • .CodeLumiaignoreのフォーマット更新とリファクタリング
  • READMEとSourceSageDocsの大幅な更新
  • GIFファイルのGit LFSでの追跡と誤記修正
  • コードのリファクタリングによる可読性と保守性の向上
  • リポジトリのURLを入力してファイルツリーとコードを表示する機能追加
  • ユーザーインターフェースの改善とドキュメンテーションの拡充
  • CI/CDの設定とREADMEファイルの更新

[2024/04/12] CodeLumia v0.1.0

  • 初回リリース

前提条件

  • Docker
  • Docker Compose

インストール

  1. リポジトリをクローンします:

    git clone https://github.com/Sunwood-ai-labs/CodeLumia.git
    cd CodeLumia
  2. Dockerコンテナをビルドして実行します:

    docker-compose up --build
  3. ブラウザで http://localhost:8501 にアクセスしてアプリケーションを開きます。

📖 使い方

  1. 分析したいGitHubリポジトリのURLをテキスト入力フィールドに入力します。
  2. アプリケーションがリポジトリをクローンし、ファイルを処理して、マークダウンのドキュメントファイルを生成します。
  3. 生成されたドキュメントがStreamlitアプリに表示されます。
  4. "Download Markdown File"リンクをクリックして、マークダウンファイルをダウンロードできます。

Tip

Full Textのところからクリップボードにコピーすることもできます

🔧 設定

  • .CodeLumiaignoreファイルには、ドキュメント生成プロセス中に無視する特定のファイルとディレクトリのパターンが含まれています。これらのパターンは、Streamlitアプリのサイドバーで編集できます。

📂 プロジェクト構造

CodeLumia/
├─ .github/
│  └─ workflows/
│     └─ run.yaml
├─ docs/
│  ├─ language_map.json
│  ├─ page_front.md
│  └─ SourceSageDocs.md
├─ modules/
│  ├─ file_operations.py
│  ├─ git_operations.py
│  └─ markdown_operations.py
├─ app.py
├─ CodeLumia.md
├─ docker-compose.yml
├─ Dockerfile
├─ README.md
└─ requirements.txt

🤝 コントリビューション

コントリビューションは大歓迎です!問題を見つけたり、改善のための提案がある場合は、issueを開くかプルリクエストを送ってください。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。

codelumia's People

Contributors

sunwood-ai-labs avatar

Stargazers

 avatar OKAMURA Naoki aka nyarla / kalaclista avatar  avatar Sandalots avatar yuiseki avatar  avatar

Watchers

 avatar  avatar

codelumia's Issues

CodeLumiaのコンセプト

指定したリポジトリをクローンしてきて,リポジトリ内のファイルをマークダウン形式にして結合
ファイルの相対パスを見出しとして記載する

結合したファイルの上部にはリポジトリのファイルのツリーが分かるようにすること

フレームワークはstreamlit

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.