This content originally appeared on DEV Community and was authored by TheoForger
As a part of the open source course I'm taking, I just created my first project. It's called Mastermind - a CLI tool that helps you cheat as a spymaster in the game of Codenames.
For the course, we were supposed to create a command line tool that processes files using a LLM model. Anything goes. A few days ago, I was watching Codenames on YouTube (I like watching party games when I'm bored haha), and the idea just hit me - Linking words together sounds like a perfect job for LLMs. And of course I chose Rust as the language, because why not?
After fumbling my way through GitHub and RustRover, my IDE of choice, I started with handling the arguments. As a Rust newbie and previous C/C++ student, I had the habit of thinking everything step by step. I spent more time than I should on std::env::Args
before I discovered the crate clap
, which handles arguments for you. Remember, lib.rs is your friend!
use std::path::PathBuf;
use clap::Parser;
/// Mastermind - An LLM-powered CLI tool to help you be a better spymaster in Codenames
#[derive(Parser, Debug)]
#[command(version, about, long_about = None)]
struct Args {
/// FILE should contain a list of words to link together - the words from your team
#[arg(short, long, value_name = "FILE")]
link: Option<PathBuf>,
/// FILE should contain a list of words to avoid - opponent's words, neutral words, and the assassin word
#[arg(short, long, value_name = "FILE")]
avoid: Option<PathBuf>,
}
fn main() {
let args = Args::parse();
println!("{:?}", args);
}
Here I had my first commit (other than those I made during setup)! It simply takes the arguments and prints them out. It's simple but it can already handle -h for help and -V for version, thanks to clap
!
I don't want to make this blog post too long, but the rest of that day was spent in a similar way. I re-familiarize myself with the pattern matching syntax in Rust. I read more about std::fs
and implemented the code to read files. I discovered more crates: serde_json
for JSON related tasks. reqwest
for API calling. dotenv
for well... reading .env
files
By the end of the day, I already had a working program that outputs the intended outcome... most of the time. I played with different system prompt but still couldn't get it right. This I might need to find another solution later...
When it works it works... Sometimes it just can't help but hallucinate...
To some degrees it felt like a day spent in wasted efforts. I kept writing code and rewriting them. But I was happy to learn things along the way. Things like:
-
if let... else
gives you clearer syntax than pattern matching. Use it instead when possible - Commit more often
- When method chaining, put each method on a new line
- Sometimes taking breaks help you solve a problem faster
- LLMs tend to hallucinate... Even if you give them clear instructions
- I still have a lot to learn about project structuring
- I don't really understand asynchronous programming that much
- ...
This content originally appeared on DEV Community and was authored by TheoForger
TheoForger | Sciencx (2024-09-10T18:32:52+00:00) First Day on My First Project. Retrieved from https://www.scien.cx/2024/09/10/first-day-on-my-first-project/
Please log in to upload a file.
There are no updates yet.
Click the Upload button above to add an update.